Metadata-Version: 2.4
Name: kestrel-feature-visual
Version: 0.1.0
Summary: Visual identity for Kestrel Sovereign agents — avatar generation, selfies, and LoRA training for character consistency
Project-URL: Homepage, https://kestrelsovereign.com
Project-URL: Source, https://github.com/KestrelSovereignAI/kestrel-feature-visual
Project-URL: Issues, https://github.com/KestrelSovereignAI/kestrel-feature-visual/issues
Author: UncleSaurus
Maintainer: UncleSaurus
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: agents,ai,avatar,image-generation,kestrel,lora,replicate
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: <3.14,>=3.11
Requires-Dist: httpx>=0.27.0
Requires-Dist: kestrel-sovereign-sdk<1,>=0.1
Requires-Dist: replicate>=1.0.4
Provides-Extra: test
Requires-Dist: pytest-asyncio>=1.1.0; extra == 'test'
Requires-Dist: pytest>=8.0.0; extra == 'test'
Description-Content-Type: text/markdown

# kestrel-feature-visual

Visual identity for Kestrel Sovereign agents — avatar generation, selfies, and LoRA training for character consistency. Uses Replicate for image generation with optional LoRA training for consistent visual identity across generated images.

## Installation

```bash
uv pip install kestrel-feature-visual
```

The feature is auto-discovered by Kestrel Sovereign via the `kestrel_sovereign.features` entry point — install it alongside `kestrel-sovereign` and the `VisualIdentityFeature` registers itself at startup.

## Configuration

| Variable | Description |
|----------|-------------|
| `REPLICATE_API_TOKEN` | Replicate API token for image generation (required for avatar/selfie tools) |

## Tools provided

- `generate_avatar` — Create a portrait avatar from a description
- `generate_selfie` — Generate a selfie in various scenes (casual, portrait, glamour, flirty, cozy, adventure, mysterious, romantic, playful, dreamy, confident)
- `train_lora` — Kick off LoRA training for character consistency (requires `kestrel-feature-lora` or another training provider installed alongside)

## Dependencies

- `kestrel-sovereign-sdk>=0.1,<1` — base `Feature`, `tool`, and `ToolCategory` interfaces
- `replicate>=1.0.4` — Replicate API client
- `httpx>=0.27.0` — HTTP transport

## Development

```bash
uv pip install -e '.[test]'
uv run pytest
```

## License

Apache-2.0
