Z-Image Image Generation System

⚠️ Do not use ToolSearch! Run scripts directly with Bash.

⚠️ Keyword Understanding (Must Read!)

User Says	Meaning	Script to Use
high quality, masterpiece, professional	Good Prompt quality	`*_quick.py`
high-res, upscale, 4K, large image	High resolution	`_highres.py` or `upscale_.py`
default (no specification)	Quick preview	`*_quick.py`

🔀 Step 1: Identify Route (Important! Check Priority)

⚠️ Route Priority Rules

Priority	Keyword	Route	Description
1 (Highest)	Riko	riko	Always use riko route when "Riko" is mentioned!
2	Hojo, Tsukasa Hojo	manga	Pure manga style
3	Satoshi, Urushihara	manga	Pure manga style

Key Understanding

"Riko in Hojo style" = riko route + Hojo LoRA overlay

Riko's fixed appearance (hairstyle, facial features) and outfit definitions only exist in generate_riko_*.py. If you use generate_manga_*.py, you'll lose Riko's characteristics!

⚠️ Prompt Extraction Rules When Using Riko

When user requests "Extract prompt from this image, then generate in Riko style":

Only extract these elements for --scene parameter:

✅ Actions, poses (sitting, standing, looking at viewer...)
✅ Emotions, expressions (smile, serious, melancholy...)
✅ Scene, background (classroom, window, sunset...)
✅ Lighting, atmosphere (soft lighting, dramatic shadow...)
✅ Composition, angle (close-up, full body, from below...)

Must discard these elements (Riko has fixed definitions):

❌ Hair color, hairstyle (blonde, ponytail, long hair...)
❌ Skin tone (tanned, pale...)
❌ Body type (slim, curvy...)
❌ Facial features (blue eyes, big eyes...)
❌ Clothing (unless user specifies maid instead of school_uniform)

🎨 Step 2: Execute Generation

DIR=/path/to/your/comfyui-zimage-skill

2.1 Riko Route (Use this whenever Riko is mentioned!)

# Pure Riko (realistic style)
python3 $DIR/generate_riko_quick.py \
  --outfit_type school_uniform \
  --scene "[scene description]"

# Riko + Hojo style (black and white manga-style Riko)
python3 $DIR/generate_riko_quick.py \
  --outfit_type school_uniform \
  --scene "[scene description]" \
  --lora "Z-image\\z-image-hojo.safetensors" \
  --style_trigger "Zanshou_kin_Hojo, monochrome, greyscale"

# Riko + Satoshi style (90s anime-style Riko)
python3 $DIR/generate_riko_quick.py \
  --outfit_type school_uniform \
  --scene "[scene description]" \
  --lora "Z-image\\z-image-satoshi.safetensors" \
  --style_trigger "sato, 90s anime style" \
  --style_tags "shiny skin, sparkle"

Outfit options: school_uniform (JK uniform) | maid (maid outfit) View options: --view_type full (full body) | --view_type upper (upper body)

2.2 Pure Manga Route (When Riko is not involved)

# Hojo style
python3 $DIR/generate_manga_quick.py \
  --lora "Z-image\\z-image-hojo.safetensors" \
  --prompt "[full prompt]"

# Satoshi style
python3 $DIR/generate_manga_quick.py \
  --lora "Z-image\\z-image-satoshi.safetensors" \
  --prompt "[full prompt]"

2.3 High-Resolution Version (When user explicitly requests "high-res")

Replace *_quick.py with *_highres.py, requires timeout=300000

📤 Step 3: Display Results

<a href="[image_url]"><img src="[image_url]" width="350"></a>

Save image_url for later upscaling!

🔍 Step 4: Upscale Existing Images

When user says "upscale" for an already generated image:

# Riko image upscale (no LoRA needed)
python3 $DIR/upscale_riko.py --image_url "[image_url]"

# Manga image upscale (needs original LoRA)
python3 $DIR/upscale_manga.py --image_url "[image_url]" --lora "[original LoRA]"

📋 Quick Decision Table

User Request	Route	Script	LoRA
Draw Riko	riko	`generate_riko_quick.py`	None
Riko in Hojo style	riko	`generate_riko_quick.py`	hojo + style_trigger
Riko in Satoshi style	riko	`generate_riko_quick.py`	satoshi + style_trigger
Mecha girl in Hojo style	manga	`generate_manga_quick.py`	hojo
Cyberpunk in Satoshi style	manga	`generate_manga_quick.py`	satoshi

⚠️ Notes

Riko first — Always use riko route when "Riko" is mentioned
LoRA path uses double backslash \\
highres/upscale needs timeout=300000
Style guides are in data/ — Do not delete