1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
|
# ComicForge configuration example.
#
# Copy this file to config.yaml and adjust the values you want to override.
# Command-line flags always take precedence over config values.
provider:
# Supported today: gemini.
# Future providers can be added here when ComicForge grows new backends.
text: gemini
image: gemini
tts: gemini
api:
# Required for Gemini-backed providers.
google_api_key: ""
models:
text: gemini-2.5-flash
image: gemini-3.1-flash-image-preview
image_text: gemini-2.5-flash
tts: gemini-2.5-flash-preview-tts
comic:
story_pages: 5
gallery_pages: 5
# 4 panels → prompt asks for ≥3 horizontal rows (not a 2×2-only layout).
panels_per_page: 4
# Gemini image aspect ratio. CLI: --aspect-ratio wins. With pdf.presentation print|book, defaults to 3:4 (A4-class) unless --aspect-ratio is set.
aspect_ratio: "16:9"
prompt_max_chars: 900
page_max_retries: 5
page_retry_base_seconds: 15
language:
input: Vocabulary
output: Story
# Language used for story and narration prompts. Must match the script of visible text
# (e.g. English story + Latin script for English vocab; Cyrillic for Bulgarian).
# Env: COMICFORGE_LANGUAGE_STORY_LANGUAGE, COMICFORGE_LANGUAGE_SCRIPT
story_language: Bulgarian
script: Latin
story:
genres:
- a warm slice-of-life story
- a heartfelt family drama
- an exciting science-fiction adventure
realistic_weight: 0.4
styles:
comic:
- classic comic book with bold ink outlines
- graphic novel with dramatic shadows
realistic:
- ultra-realistic DSLR photography, cinematic 35mm lens
- cinematic realism with natural light
cartoon:
- extremely cartoonish 1930s rubber-hose funny-animal comic style, original mouse-and-duck-era mascot energy, pie-cut eyes, button noses or beaks, white gloves, oversized shoes, noodle arms, squash-and-stretch bodies, round heads, huge expressions, flat candy colors, absolutely no realism
- vintage theatrical funny-animal cartoon comic style, redesign people as original anthropomorphic mascot characters with beaks or round snouts, pie-cut eyes, white gloves, oversized shoes, elastic limbs, slapstick poses, no realistic anatomy
action_90s:
- 1990s superhero comic splash-page style like a bold caped hero punching a masked villain in a city, huge muscles, spandex costumes, explosions, halftone print texture
- classic 90s action superhero cover style, oversized yellow masthead energy, caped spandex hero, armored villain, city skyline, speech balloons, Ben-Day dots
manga:
- true monochrome Japanese shonen manga page, black ink only with grey screentone, no western color rendering, large expressive anime eyes, sharp spiky hair silhouettes, sweat drops, impact bursts, speed-line backgrounds, exaggerated emotion close-ups, dynamic diagonal manga panel language
- authentic serialized manga action art, crisp black linework, dense screentone gradients, white paper highlights, hand-drawn Japanese comic energy, chibi reaction inset, dramatic sound-effect shapes, cinematic close-ups, no painterly western comic coloring
horror:
- vintage horror comic style, eerie shadows, gothic atmosphere, unsettling monsters
- creepy supernatural horror comic style, fog, haunted architecture, heavy inks
watercolor:
- pure transparent watercolor storybook comic style, visible cold-press paper grain, watery pigment blooms, uneven wash edges, granulation, soft bleeding colors, pale layered washes, loose pencil underdrawing, no digital airbrush, no oil-paint texture, no glossy comic coloring
- hand-painted watercolor children's adventure style, translucent pastel washes, wet-on-wet skies, dry-brush texture, white paper highlights, delicate ink-and-pencil outlines, puddled pigment edges, airy negative space, gentle low-contrast rendering
pulp:
- retro pulp adventure cover style, painted poster energy, dramatic rim light, saturated inks, worn paper grain, bold composition, vintage print imperfections
- mid-century pulp sci-fi comic style, chromatic airbrushed highlights, atomic-age props, bold diagonals, distressed halftone texture, high adventure mood
mecha:
- high-detail mecha comic style, hard-surface armor plates, mechanical joints, cockpit glass reflections, technical line art, industrial lighting
- anime mecha action page style, towering robots, dynamic perspective, panel-like motion energy, sparks and smoke, crisp cel-shaded rendering
pixel_art:
- 16-bit pixel-art comic scene, limited palette, clean pixel clusters, deliberate dithering, retro game-era perspective, sharp pixel edges
- retro pixel-art storyboard style, chunky sprites, high-contrast palette ramps, tiled-environment texture, no anti-aliasing, classic console look
ink_wash:
- ink-wash brush painting style, sumi-e inspired strokes, expressive black ink gradients, controlled bleed on paper, minimal but dramatic composition
- monochrome ink-and-wash comic style, calligraphic brush lines, soft gray washes, negative-space storytelling, textured rice-paper feel
clay:
- stop-motion clay diorama style, hand-sculpted clay characters, thumbprint texture, miniature set lighting, tactile handcrafted look
- plasticine comic tableau style, sculpted figures, soft studio shadows, practical miniature props, playful clay surface detail
narration:
voices:
- Charon
- Fenrir
chunk_words: 100
# Final PDF assembly (ImageMagick `convert` on PATH). CLI: --pdf-jpeg-quality, --pdf-presentation.
# Env: COMICFORGE_PDF_DENSITY, COMICFORGE_PDF_JPEG_QUALITY, COMICFORGE_PDF_PRESENTATION
pdf:
density: 150
# 0 = default; 1–100 = JPEG inside PDF (smaller file).
jpeg_quality: 0
# none | print | book — print/book output ISO A4 portrait PDF pages; book also ages, tilts, shadows, thick edge.
presentation: none
# Directory that ComicForge uses for prompt templates.
prompts_dir: ./prompts
|
