Files

T

Claude b2d064573f Move ai-stack and paintplus vendored source under vendor/

Matches the existing vendor/easy-asterisk convention (used by
services/asterisk.sh) instead of two one-off top-level directories that
cluttered the repo root and didn't look like anything else next to
setup.sh, lib/, services/, extras/. Only the two services' own SRC_DIR
path resolution and header comments needed updating — nothing else in
the repo referenced the old ./ai-stack / ./paintplus paths.

Also documents vendor/ in README.md's Layout section.

2026-08-04 12:55:09 +00:00

3.1 KiB

Raw Blame History

Classic Eyes Scripts

This directory contains scripts for generating and importing classic eye images into the AI Photo Edit patch library.

Overview

The scripts generate a variety of classic eye styles that can be used as reusable patches for photo editing:

Realistic eyes - Detailed eyes with gradient irises and realistic highlights
Anime eyes - Large, expressive eyes in anime style with prominent highlights
Cartoon eyes - Simple, bold cartoon-style eyes

Each style is available in multiple iris colors: blue, green, brown, hazel, grey, and amber.

Scripts

1. `generate_classic_eyes_ppm.py`

Generates classic eye images using only the Python standard library (no dependencies required).

python scripts/generate_classic_eyes_ppm.py

This creates PPM format images in data/classic_eyes_ppm/. PPM is a simple image format that can be converted to PNG later.

2. `download_classic_eyes.py`

Full-featured script that generates eyes and imports them directly into the patch library. Requires PIL/Pillow.

# Run inside the backend container
docker exec -it ai-photo-edit-backend python /app/../scripts/download_classic_eyes.py

# Or with the API running
python scripts/download_classic_eyes.py --api --base-url http://localhost:8101

# Or save to a directory for later import
python scripts/download_classic_eyes.py --output-dir ./my_eyes

3. `startup_import_eyes.py`

Converts PPM files to PNG and imports them into the patch library. Run this inside the backend container.

docker exec -it ai-photo-edit-backend python /app/../scripts/startup_import_eyes.py

4. `import_saved_eyes.py`

Import previously saved eye images from a directory.

python scripts/import_saved_eyes.py /path/to/saved/eyes

Quick Start

Generate the eye images (no dependencies needed):
```
python scripts/generate_classic_eyes_ppm.py
```
Start the application:
```
docker compose up -d
```

Import the eyes:

docker exec -it ai-photo-edit-backend python /scripts/startup_import_eyes.py

Verify in the app: Open the patch library in the UI to see the imported classic eyes.

Generated Eyes

Style	Colors Available	Size
Realistic	Blue, Green, Brown, Hazel, Grey, Amber	200x200
Anime	Blue, Green, Brown, Hazel, Grey, Amber	200x200
Cartoon	Blue, Green, Brown, Hazel, Grey, Amber	200x200

Total: 18 unique eye variants

Extending

To add more eye styles or colors, edit the generate_classic_eyes_ppm.py or download_classic_eyes.py scripts:

# Add new color
colors["purple"] = (128, 0, 128)

# Add new style in create_classic_eye() function
elif style == "fantasy":
    # Your custom eye drawing code
    pass

File Formats

PPM: Portable Pixmap format - simple, universal, generated without dependencies
PNG: Preferred format for the patch library - converted from PPM using PIL

License

The generated eye images are created programmatically and are free to use without restrictions.

3.1 KiB Raw Blame History