Z-Image Image Generation System

Run all generation scripts directly with Bash. Do not use ToolSearch — all scripts are local.

Riko routing rule: Any request mentioning "Riko" must use generateriko.py (not generatemanga.py). Riko's fixed appearance and outfit definitions only exist in the Riko scripts. Style LoRAs can be layered on top via --lora and --style_trigger flags. See the decision table below.

Step 1: Identify Route

Resolution keyword guide

Prompt extraction for Riko requests

When extracting a prompt from a reference image for Riko generation, pass only scene-level elements to --scene:

• Include: actions, poses, emotions, expressions, scene/background, lighting/atmosphere, composition/angle
• Discard: hair color/style, skin tone, body type, facial features, clothing (unless user specifies maid instead of schooluniform) — Riko has fixed definitions for these in data/rikocharacter.py

Step 2: Execute Generation

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

Riko route

# 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: schooluniform (JK uniform) | maid (maid outfit) View options: --viewtype full (full body) | --view_type upper (upper body)

Manga route (no Riko)

# 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]"

High-resolution version

Replace quick.py with highres.py. Set timeout=300000 for high-res generation.

Step 3: Validate and Display Results

After running a generation script, check the exit code before displaying:

python3 $DIR/generate_riko_quick.py --outfit_type school_uniform --scene "standing by window"
if [ $? -ne 0 ]; then
  echo "Generation failed — check that ComfyUI is running and the model/LoRA paths are correct."
else
  # Display the generated image
  echo '<a href="[image_url]"><img src="[image_url]" width="350"></a>'
fi

Save the returned image_url for later upscaling.

Step 4: Upscale Existing Images

When the 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

Notes

• LoRA path uses double backslash \\ in the --lora argument
• High-res and upscale require timeout=300000
• Style guides in data/ (stylehojo.md, stylesatoshi.md) — consult for prompt crafting, do not delete