Ideogram 4 Quad Frame

A storyboard is just a sequence of frames, and in this pack a frame is a Ideogram4QuadFrame. It's the small node that says: this panel sits in this corner, this is what happens in it, and these are the characters on stage. On its own it does nothing visible - it's a bundle of information - but it's the unit you wire into the Prompt Builder, and it's where the actual storytelling happens.

What it holds

Three kinds of data, all of it forward-looking:

• position - which of the four cells the frame targets: top-left, top-right, bottom-left, or bottom-right (plus none if you're holding it as a spare). The Prompt Builder uses this to drop the panel's text into the right bounding box.
• action - the shot description, the moment. "Mara pushes through the saloon doors." This describes what happens, not what the characters look like - the appearance lives in the Reference nodes.
• subject_1, subject_2, subject_3 - up to three Reference nodes (from Ideogram4QuadSubject) wired in as the frame's cast. Whichever References you connect are whoever appears in this panel; wire the same Reference into several frames and that character recurs across the storyboard.

There's also a color_palette string field for a few hex colors, which overrides the palette the scene otherwise inherits from its subjects.

The output is a single frame (QUAD_FRAME) that bundles all of it together. Build up to four of these - one per panel - and feed them into the Prompt Builder's frame_a through frame_d inputs.

How it fits the workflow

The division of labor is deliberate and it's worth internalizing: Reference nodes own who/what, Frame nodes own where and what happens, and the Prompt Builder owns how it all gets phrased. Because a Frame only carries references and an action, the same cast member can move through the story without you retyping their description - the description lives in one place, the Reference, and every frame reuses it. That's the mechanism behind the per-subject consistency this pack is built around, and Ideogram 4's unusually strong character recall is what makes it actually work rather than merely hoping.

Installing

cd ComfyUI/custom_nodes
git clone https://github.com/reality-comes/comfyui-ideogram4-quad-storyboard

Restart ComfyUI; it lands under image/ideogram4 (ComfyUI Manager: search "Ideogram 4 Quad Storyboard"). No extra dependencies - the pack uses ComfyUI's bundled torch and comfy, and this node is just data assembly on top.

Where people get burned

The position field is the one that bites. It must be one of the four real cells - the Prompt Builder only places panels whose position is top-left, top-right, bottom-left, or bottom-right, and silently skips anything else. And a small reminder that saves people an afternoon: if you're only compositing reference images into the quad canvas and never generating the JSON prompt, you don't need Frame nodes at all. They exist entirely for the prompt side. But the moment you want a real storyboard - recurring characters, consistent setting, coherent shots - this is where the story gets written.