Metadata-Version: 2.4
Name: iil-illustrationfw
Version: 0.3.0
Summary: Provider-agnostic illustration framework for IIL projects
Author-email: Achim Dehnert <achim.dehnert@iil.gmbh>
License: Proprietary
License-File: LICENSE
Keywords: dalle,illustration,image-generation,stable-diffusion
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.12
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: mypy>=1.8; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.3; extra == 'dev'
Provides-Extra: django
Requires-Dist: django>=4.2; extra == 'django'
Provides-Extra: pillow
Requires-Dist: pillow>=10.0; extra == 'pillow'
Description-Content-Type: text/markdown

# iil-illustrationfw

**Provider-agnostic illustration framework** for IIL projects — DALL·E 3, Stable Diffusion, Mock.
Prompt-building from book/story context, StyleDNA injection.

[![PyPI](https://img.shields.io/pypi/v/iil-illustrationfw)](https://pypi.org/project/iil-illustrationfw/)
[![Python](https://img.shields.io/pypi/pyversions/iil-illustrationfw)](https://pypi.org/project/iil-illustrationfw/)
[![License: Proprietary](https://img.shields.io/badge/License-Proprietary-red.svg)]()

Architecture: [ADR-084](https://github.com/achimdehnert/bfagent/blob/main/docs/adr/ADR-084-illustration-framework-pypi-package.md)

## Installation

```bash
pip install iil-illustrationfw
# With Django integration:
pip install "iil-illustrationfw[django]"
# With image processing:
pip install "iil-illustrationfw[pillow]"
```

## Extras / Optional Dependencies

| Extra | Dependencies | Purpose |
|---|---|---|
| `django` | django>=4.2 | Django AppConfig + view helpers |
| `pillow` | pillow>=10.0 | Local image processing + resizing |

## Quick Start

```python
from illustrationfw import IllustrationPipeline, DALLEProvider

pipeline = IllustrationPipeline(provider=DALLEProvider(api_key="..."))

result = pipeline.generate(
    context={"title": "The Iron Forest", "genre": "fantasy"},
    style_dna={"tone": "dark", "palette": "muted"},
)
print(result.image_url)
```

## Used By

- `illustration-hub` — primary consumer
- `bfagent` — book illustration pipeline
- `writing-hub` — scene illustration

## Changelog

See [CHANGELOG.md](CHANGELOG.md).
