Creative Illustration Factory

Generate professional illustrations for books, editorial content, children's stories, and creative projects.

Setup

• Needs env:

  OPENAI_API_KEY

Quick Start

Generate a simple illustration:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a cozy cottage in an enchanted forest"

Generate with specific style:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a robot learning to paint" \
  --style "watercolor" \
  --mood "whimsical"

Generate a story sequence:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Alice discovers a tiny door" \
  --subject "Alice shrinks down" \
  --subject "Alice enters Wonderland" \
  --style "whimsical illustration" \
  --mood "magical"

Illustration Types

Book Illustrations

• chapter-opener

  - Full-page chapter opening scene

• character-intro

  - Character introduction portrait

• landscape-scene

  - Wide landscape establishing shot

• action-moment

  - Dynamic action or pivotal moment

• emotional-scene

  - Emotional or dramatic scene

• cover-art

  - Book cover illustration style

Editorial / Magazine Art

• conceptual-art

  - Abstract conceptual illustration

• info-graphic

  - Informational illustration style

• portrait-editorial

  - Editorial portrait

• spot-illustration

  - Small spot illustration

• full-page-spread

  - Magazine full-page spread

Children's Book Art

• picture-book

  - Classic picture book illustration

• whimsical

  - Playful and imaginative style

• educational

  - Educational book illustration

• bedtime-story

  - Soft, calming bedtime story art

• adventure-map

  - Adventure map or treasure map

Concept Art

• environment-concept

  - Environmental concept art

• character-concept

  - Character design concept

• prop-concept

  - Object or prop design

• storyboard

  - Storyboard panel style

• mood-board

  - Mood board aesthetic

Styles

Traditional Media

• watercolor

  - Watercolor painting with soft edges

• oil-painting

  - Rich oil painting texture

• charcoal-sketch

  - Charcoal drawing style

• ink-wash

  - Ink wash / sumi-e style

• pastel

  - Soft pastel drawing

• colored-pencil

  - Colored pencil illustration

• gouache

  - Gouache opaque watercolor

• acrylic

  - Acrylic painting style

• lino-cut

  - Linocut printmaking style

• woodcut

  - Woodcut print aesthetic

Digital Styles

• digital-painting

  - Digital painting

• vector-illustration

  - Clean vector art

• flat-design

  - Flat design aesthetic

• isometric

  - Isometric perspective

• pixel-art

  - Retro pixel art

• concept-art

  - Game/film concept art style

• cel-shaded

  - Cel shaded animation style

• low-poly

  - Low poly 3D aesthetic

Book & Print Styles

• picture-book

  - Classic picture book

• storybook-illustration

  - Vintage storybook art

• editorial-illustration

  - Magazine editorial

• newspaper-engraving

  - Newspaper engraving style

• poster-art

  - Vintage poster design

• woodblock-print

  - Japanese woodblock print

• screen-print

  - Screen print aesthetic

Mood

• whimsical

  - Playful and imaginative

• magical

  - Magical and enchanting

• mysterious

  - Mysterious and intriguing

• peaceful

  - Calm and serene

• dramatic

  - Dramatic and intense

• nostalgic

  - Warm and nostalgic

• gloomy

  - Dark and atmospheric

• vibrant

  - Bright and energetic

• romantic

  - Soft and romantic

• quirky

  - Quirky and eccentric

Parameters

• --subject

  - Illustration subject/description (repeatable for batch)

• --type

  - Illustration type (default: illustration)

• --style

  - Artistic style (default: watercolor)

• --mood

  - Mood/atmosphere (default: peaceful)

• --palette

  - Color palette suggestion

• --composition

  - Composition guidance (e.g., "wide shot", "close-up")

• --count

  - Number of variants per subject (default: 1)

• --out-dir

  - Output directory (default: ~/Projects/tmp/creative-illustration-*)

• --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)

Advanced Examples

Children's book page:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "a curious rabbit with a pocket watch" \
  --type "picture-book" \
  --style "watercolor" \
  --mood "whimsical" \
  --palette "pastel"

Editorial concept art:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "AI and humanity working together" \
  --type "conceptual-art" \
  --style "vector-illustration" \
  --mood "optimistic" \
  --composition "symbolic"

Story sequence:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Hero finds an ancient map" \
  --subject "Hero deciphers mysterious symbols" \
  --subject "Hero discovers a hidden passage" \
  --subject "Hero enters the forgotten temple" \
  --style "storybook-illustration" \
  --mood "mysterious" \
  --palette "earth tones"

Full custom prompt:

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --prompt "A magical treehouse library nestled among ancient redwoods, spiral staircase winding up the trunk, lanterns hanging from branches, books floating in mid-air, warm golden light streaming through leaves, detailed watercolor illustration style, whimsical and enchanting"

Color Palettes

• pastel

  - Soft pastel colors

• earth tones

  - Natural browns, greens, golds

• vibrant

  - Bright saturated colors

• muted

  - Desaturated, subtle colors

• monochrome

  - Single color variations

• jewel tones

  - Rich ruby, emerald, sapphire

• autumn

  - Orange, red, yellow, brown

• winter

  - Blue, white, silver, purple

• tropical

  - Bright greens, teals, pinks

• vintage

  - Warm sepia, faded tones

Composition

• wide shot

  - Wide establishing scene

• close-up

  - Intimate close-up

• panoramic

  - Panoramic landscape

• rule-of-thirds

  - Balanced rule of thirds

• centered

  - Centered subject

• diagonal

  - Dynamic diagonal composition

• triangular

  - Triangular composition

• circular

  - Circular / spiral composition

• symmetrical

  - Perfectly symmetrical

• asymmetrical

  - Asymmetrical balance

Output

• *.png

  - Illustration images

• prompts.json

  - All prompts used

• index.html

  - Illustration gallery

Project Templates

Children's Book (4-6 images)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "Girl finds a magical seed" \
  --subject "Seed grows into a glowing plant" \
  --subject "Plant reveals a tiny fairy" \
  --subject "Fairy shows girl a secret garden" \
  --subject "Girl shares garden with friends" \
  --type "picture-book" \
  --style "watercolor" \
  --mood "whimsical"

Magazine Editorial (1-2 images)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "The future of sustainable cities" \
  --type "conceptual-art" \
  --style "vector-illustration" \
  --mood "optimistic" \
  --count 2

Fantasy Story Chapter Opener (1 image)

python3 ~/Projects/agent-scripts/skills/creative-illustration/scripts/illustrate.py \
  --subject "The dragon's treasure hoard under ancient runes" \
  --type "chapter-opener" \
  --style "oil-painting" \
  --mood "dramatic" \
  --palette "jewel tones"