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"