ComfyUI Image Gen

ComfyUI Image Gen

Overview

Use this single skill for both:

• direct ComfyUI API workflow runs (run_workflow.sh)
• orchestrated page pipelines (run_phase.sh + RenderSpec/​review artifacts)

Keep runs reproducible by preserving workflow JSON, explicit bindings, seeds, run metadata, and per-page artifacts.

Modes

Mode A: Direct workflow run

Use when you already have an .api.json workflow and want to queue/​download outputs quickly.

Flow:

1. Check endpoint health (scripts/​check_comfy.sh).
2. Select strongest available model stack (prefer FLUX > SDXL > SD1.x/​2.x).
3. Run scripts/​run_workflow.sh with explicit --set overrides.
4. Inspect outputs and iterate one variable at a time.

Mode B: Orchestrated page pipeline

Use when producing books/​multi-page assets with stable artifacts and deliberate QA.

Flow:

1. Verify setup (scripts/​check_setup.sh).
2. Ensure Comfy runtime is available (scripts/​start_comfy.sh) when hosting locally.
3. Author/​update renderspec.json.
4. Run one phase at a time via scripts/​run_phase.sh.
5. Inspect per-page outputs and record decisions in review.json before refine/​final steps.
6. Keep renderspec.json, review.json, and jobs/​*.json manifests.

Commands

Endpoint health:

$CODEX_HOME/​skills/​comfyui-image-gen/​scripts/​check_comfy.sh \
  --comfy-url http://192.168.1.224:8188 \
  --check-object-info

Direct workflow run:

$CODEX_HOME/​skills/​comfyui-image-gen/​scripts/​run_workflow.sh \
  --comfy-url http://192.168.1.224:8188 \
  --workflow workflows/​draft.api.json \
  --set "3.inputs.text=storybook scene, no text" \
  --set "7.inputs.noise_seed=123456" \
  --out-dir output/​comfy

Pipeline setup check:

$CODEX_HOME/​skills/​comfyui-image-gen/​scripts/​check_setup.sh

Pipeline draft phase:

$CODEX_HOME/​skills/​comfyui-image-gen/​scripts/​run_phase.sh \
  --book-id gingerbear_01 \
  --page 7 \
  --phase draft \
  --renderspec $CODEX_HOME/​skills/​comfyui-image-gen/​templates/​renderspec.example.json \
  --books-dir books

Pipeline refine phase:

$CODEX_HOME/​skills/​comfyui-image-gen/​scripts/​run_phase.sh \
  --book-id gingerbear_01 \
  --page 7 \
  --phase refine \
  --renderspec books/​gingerbear_01/​pages/​0007/​renderspec.json \
  --review books/​gingerbear_01/​pages/​0007/​review.json \
  --source-image books/​gingerbear_01/​pages/​0007/​draft/​001_some_image.png \
  --books-dir books

Model selection rule

Before queueing, state the exact model components used (checkpoint/​UNet, text encoders, VAE). Always prefer the strongest compatible family available:

• FLUX
• SDXL
• SD1.x/​2.x (fallback only)

Operating rules

• Do not assume a fixed workspace path; use explicit paths/​URLs when available.
• Prefer workflow JSON + explicit bindings over manual UI node edits.
• Treat prompt + workflow + seed as a reproducibility unit.
• Keep generated art free of text unless explicitly requested.
• For multi-page books, QA in small batches and regenerate only flagged pages.

References

• references/​comfy-api.md for endpoint contracts and run lifecycle.
• references/​prompting.md for compact prompt-spec patterns.
• references/​local-workflow.md for RenderSpec/​pipeline path contracts.
• plans.md for phase-by-phase orchestration guidance.