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"