Status: M1 — Rectangle vertical-stack. See docs/superpowers/specs/2026-04-23-comfyui-comic-batch-node-design.md for the full design; docs/superpowers/plans/ for milestones.

Install

Clone this repo into ComfyUI/custom_nodes/, then:

pip install -e .[dev]

Restart ComfyUI.

Nodes

Node	Purpose
`Comic Script Loader`	Load + validate JSON; emits `COMIC_SCRIPT`. Modes: `file` / `path` / `inline`.
`Comic Batch Generator`	Inner for-loop over panels. Connect `MODEL / CLIP / VAE`; no KSampler needed. Supports resume via panel-hash cache.
`Comic Page Composer`	Assemble panels into full pages. Outputs composed IMAGE batch + bbox metadata + pass-through panels.

Example workflow

Drop examples/workflows/m1_basic_vertical_stack.json into ComfyUI. Place basic.json (see tests/fixtures/scripts/) at ComfyUI/input/comics/basic.json.

Running tests

pytest tk_comfyui_batch_image/tests/ -v
ruff check tk_comfyui_batch_image

Current limitations (M1)

Shapes: rectangle only (no split / polygon yet → M3/M4)
Layout modes: vertical_stack only (no custom_grid yet → M3)
No debug overlay (→ M5)
No standalone JSON-validation CLI (→ M2)
No SKILL.md skill package for AI script generation (→ M2)