Metadata-Version: 2.4
Name: artdo-ai
Version: 0.1.0
Summary: Official Python client and workflow utilities for ArtDo AI Photo Editor (https://artdo.ai/).
Author-email: ArtDo Team <support@artdo.ai>
License: MIT
Project-URL: Homepage, https://artdo.ai/
Project-URL: Documentation, https://artdo.ai/
Project-URL: Source, https://artdo.ai/
Project-URL: Bug Tracker, https://artdo.ai/
Keywords: photo-editor,ai-photo-editing,image-processing,artdo,artdo-ai
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Image Processing
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Dynamic: license-file

# ArtDo AI: Python Client for ArtDo AI Photo Editor

[![PyPI version](https://img.shields.io/pypi/v/artdo-ai.svg)](https://pypi.org/project/artdo-ai/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

Official Python client and workflow utilities for [ArtDo AI Photo Editor Online](https://artdo.ai/).

## Overview

[ArtDo](https://artdo.ai/) is a browser-based AI photo editor for uploading JPG, PNG, or WebP images, describing the desired edit, choosing currently available compatible settings, generating an image, reviewing it, and downloading the result.

### Key Capabilities
- **Prompt-Guided Photo Editing**: Describe desired changes in plain text to transform source images.
- **Background Removal & Replacement**: Isolate subjects with fine edge detection and apply new scenes or solid backdrops.
- **Object Inpainting & Cleanup**: Remove unwanted elements or distractions smoothly.
- **Upscaling & Enhancement**: Super-resolution processing and high-detail enhancement.
- **Canvas Outpainting**: Expand margins across standard aspect ratios.

## Installation

```bash
pip install artdo-ai
```

## Quick Start

```python
from artdo_ai import ArtDoClient

client = ArtDoClient(base_url="https://artdo.ai")

# Check service readiness and capabilities
status = client.health_check()
print(status)
```

## What to Keep in Mind

ArtDo is image-only. Models, login requirements, resolutions, ratios, input counts, credit costs, and provider availability are dynamic. The current public static routes are English only. AI output quality, uniqueness, exact prompt compliance, and suitability for a specific purpose are not guaranteed. Uploaded images, prompts, and settings are sent to the configured AI processing service.

For the latest updates and interactive web editor, visit [https://artdo.ai/](https://artdo.ai/).

## Links & Resources

- Official Website: [https://artdo.ai/](https://artdo.ai/)
- Documentation & Web App: [https://artdo.ai/](https://artdo.ai/)
- PyPI Package: [https://pypi.org/project/artdo-ai/](https://pypi.org/project/artdo-ai/)
- npm Package: [https://www.npmjs.com/package/artdo-ai](https://www.npmjs.com/package/artdo-ai)

## License

MIT License. See LICENSE for details.
