style-transfer

# Style Transfer Pro

Apply artistic style transfer to images using OpenAI Images API with curated style prompts.

## Setup

- Needs env: `OPENAI_API_KEY`
- Needs source image URL (public URL or base64 data URI)

## Quick Start

Transform an image to oil painting style:

```bash
python3 ~/Projects/agent-scripts/skills/style-transfer/scripts/transfer.py \
  --source "https://example.com/photo.jpg" \
  --style "oil painting on linen, impressionist brushwork, rich texture, van gogh style"
```

Transform to multiple styles at once:

```bash
python3 ~/Projects/agent-scripts/skills/style-transfer/scripts/transfer.py \
  --source "https://example.com/photo.jpg" \
  --style "oil painting" \
  --style "watercolor illustration" \
  --style "cyberpunk neon" \
  --style "vintage sepia photograph"
```

## Style Library

Use these pre-defined style names (or provide custom prompts):

### Art Movements
- `impressionist-oil` - Impressionist oil painting with visible brushwork
- `watercolor-dream` - Soft watercolor with ink linework
- `digital-art` - Modern digital art with crisp details
- `comic-book` - Bold comic book illustration style
- `anime-studio` - Anime/ manga studio style
- `pixel-art` - Retro pixel art aesthetic
- `vector-flat` - Clean flat vector illustration
- `surreal-abstract` - Surrealist abstract art

### Photographic Styles
- `vintage-sepia` - Sepia vintage photography
- `polaroid` - Instant polaroid look with faded tones
- `film-noir` - Black and white film noir aesthetic
- `candid-snapshot` - Authentic snapshot look
- `studio-portrait` - Professional studio photography
- `vogue-editorial` - Fashion editorial style
- `golden-hour` - Golden hour warm lighting
- `neon-noir` - Cyberpunk neon noir

### Period Styles
- `renaissance-portrait` - Classical Renaissance oil painting
- `baroque-drama` - Dramatic Baroque chiaroscuro
- `art-deco-elegance` - Art Deco geometric elegance
- `mid-century-modern` - Mid-century modern illustration
- `victorian-etching` - Victorian etching aesthetic
- `steampunk-gear` - Steampunk mechanical style
- `dystopian-grunge` - Dystopian grunge aesthetic
- `psychedelic-60s` - 1960s psychedelic art

## Custom Style Prompts

For fine-grained control, provide full style prompts:

```bash
python3 ~/Projects/agent-scripts/skills/style-transfer/scripts/transfer.py \
  --source "https://example.com/photo.jpg" \
  --prompt "watercolor painting, soft brushstrokes, pastel color palette, hand-painted illustration style, minimal detail, elegant and dreamy"
```

Style prompt structure:
1. Medium: "oil painting", "watercolor", "digital art", "photography"
2. Technique: "impressionist", "glazing", "crosshatching", "flat design"
3. Lighting: "softbox", "golden hour", "dramatic chiaroscuro", "diffuse"
4. Color: "pastel", "muted", "vibrant", "muted earth tones"
5. Quality: "ultra-detailed", "minimalist", "sketch", "finished artwork"

## Parameters

- `--source` - Source image URL (required)
- `--style` - Pre-defined style name (repeatable)
- `--prompt` - Full custom style prompt (overrides --style)
- `--out-dir` - Output directory (default: ~/Projects/tmp/style-transfer-*)
- `--size` - Image size: 1024x1024, 1792x1024, 1024x1792 (default: 1024x1024)
- `--quality` - high/standard (default: high)
- `--model` - OpenAI image model (default: gpt-image-1.5)
- `--api-key` - OpenAI API key (or use OPENAI_API_KEY env)

## Output

- `*.png` - Transformed images
- `prompts.json` - Style prompts used
- `index.html` - Thumbnail gallery comparing styles