prettycomic

PrettyComic

Generates comic-style illustrations from text descriptions with optional reference images for consistent character/style.

Plugin root: ${CLAUDE_PLUGIN_ROOT}

First-time setup

Before anything else, check if ${CLAUDE_PLUGIN_ROOT}/.env exists.

If it does NOT exist, ask the user:

You need a Google Gemini API key for image generation. Get one for free at https://aistudio.google.com/apikey

Then create the .env file:

GEMINI_API_KEY=<their key>

Write this to ${CLAUDE_PLUGIN_ROOT}/.env.

Optionally ask: "Do you also have a Kie.ai API key for fallback rendering? (Enter to skip)" If yes, append KIE_API_KEY=<key> to .env.

Workflow

Step 1: Understand the request

Parse what the user wants:

• Scene description — what should be in the image
• Style — comic (default), manga, cyberpunk, retro, pixel
• Reference image — optional path to an existing image for style consistency

Step 2: Generate

Run:

cd "${CLAUDE_PLUGIN_ROOT}"
source .venv/bin/activate 2>/dev/null || bash scripts/setup.sh
python generate.py "<scene description>" --style <style> -o output/<slug>.png

With reference image:

python generate.py "<scene description>" --ref <path-to-reference.png> --style <style> -o output/<slug>.png

Step 3: Show result

Open the generated image:

xdg-open "${CLAUDE_PLUGIN_ROOT}/output/<slug>.png"

Share the path with the user and ask if adjustments are needed.

Styles

Style	Description
comic	Classic colorful comic book / webcomic (default)
manga	Japanese manga with speed lines, screen tones
cyberpunk	Dark futuristic with neon colors, glitch effects
retro	1960s pop art, halftone dots, bold primary colors
pixel	16-bit pixel art, limited color palette

Reference Images

Pass --ref <path> to maintain visual consistency:

• Same character design across multiple panels
• Consistent art style for a series of images
• Match an existing illustration's look and feel

The model will match line weight, coloring technique, and character proportions from the reference.

Options

generate.py "<description>" [options]

--ref PATH          Reference image for style consistency
--style STYLE       Visual style preset (default: comic)
-o, --output PATH   Output path (default: output/comic.png)
--resolution 1K|2K|4K  Resolution (default: 2K)
--aspect-ratio      Aspect ratio (default: 16:9)
--backend kie|gemini  Override backend

Requirements

• GEMINI_API_KEY in ${CLAUDE_PLUGIN_ROOT}/.env
• KIE_API_KEY optional (fallback)
• Python 3.11+ (setup script handles the rest)