MiniMax H3 Contex Loop Start
Start or resume an H3 chain — yes, resuming is the good part
- plan
- source_audio
- external_context
- source_timeline
- flow
- state
- status
MiniMax H3 Contex Loop Start is the entry point to the recursion that makes this pack different from a one-shot H3 render. It takes a validated Plan, kicks off scene 1, and - the part nobody else gives you for free - lets you resume an interrupted production from any contiguous scene without rerendering what you already approved.
The trick that makes the whole loop work: Loop Start is only fully executed once, at the top of the run. Inside the recursion, ComfyUI re-invokes it with the loop's internal state and it acts as a pass-through - the flow output is a raw link that defines the recursive body, and Loop End clones that body for later scenes. That's why the tooltip is so insistent: flow must connect directly to Loop End's flow input, not through other nodes. Break that and the recursion can't self-clone.
The inputs you'll set
plan- the validated output from H3 Chain Plan. Nothing happens without it.start_clip- legacy/resume scene to render next.1starts a new chain. A value above 1 loads and validates the saved checkpoint for the preceding scene before resuming - this is the resume mechanism.scene_range(optional) - the modern way to pick your range. Leave blank to run fromstart_clipto the end;3runs only scene 3;3:8runs scenes 3 through 8. A start above 1 requires the preceding checkpoint, and disjoint comma selections are rejected because they'd break continuity.verify_resume_history(optional, default ON) - the safety rail. It requires every completed predecessor to match the current Plan's prompts, seeds, timing, source audio, model and reference fingerprint before it will resume. Turn it off only to deliberately reuse a saved predecessor after changing the Plan. The docs are blunt: even with it off, missing files, SHA-256 artifact integrity, checkpoint tensor shape and internal metadata consistency are still verified. Changes to a predecessor are never applied retroactively.external_context(optional) - the output of MiniMax H3 Existing Video Context, when scene 1 should continue imported footage.source_timeline/source_audio(optional) - the 0.5 and legacy media routes respectively. They're mutually exclusive; connect one. In 0.5,source_timelinefrom the Source Timeline node is the primary route and stays lazy across recursive scenes.source_audiois the old full-AUDIO route, saved once as a path-backed run asset.
The outputs
flow (to Loop End), state (to Current Shot and the recursive body), and status - a STRING reporting the starting scene, total count, and resume/padding status. That status line is genuinely informative: it'll tell you when a run resumed, when history verification was disabled, and when silent source audio is being padded.
Where it shines
The preflight. Before H3 loads, Loop Start validates timing, media, references, compatibility and resume state - you find out about a broken scene_range or a mismatched Plan before burning a 40-minute render, which is exactly the kind of forethought the rest of ComfyUI usually leaves to you.
Installing it
Part of ComfyUI-MiniMaxH3-Contex-Loop (ComfyUI Manager: "MiniMax H3 Contex Loop"), or:
cd ComfyUI/custom_nodes && git clone https://github.com/ethanfel/ComfyUI-MiniMaxH3-Contex-Loop.git
Restart ComfyUI. Requires H3 weights and a current ComfyUI with native Add Guide (PR #15439).
Common issues
The top resume gotcha is a changed Plan: you edited scene 2's prompt after scene 1 was accepted, and resume refuses because verify_resume_history catches the mismatch. That's a feature - the fix is either reverting the change or deliberately disabling verification. And if you connect both source_timeline and source_audio, Loop Start raises a clear error rather than guessing. Most "stuck at scene 1" reports trace back to a broken flow connection; recheck that raw link first.
Inputs (7)
| Name | Type | Default | Description |
|---|---|---|---|
| plan | H3_CHAIN_PLAN | Validated output from H3 Chain Plan. | |
| start_clip | INT | 11–128 | Legacy/resume scene to render next. Use 1 for a new chain. A non-empty scene_range overrides this value. A value above 1 loads and validates the saved checkpoint for the preceding scene before resuming. |
| scene_rangeopt | STRING | Inclusive contiguous scenes to generate. Leave blank to run from start_clip through the end; use 3 for only scene 3 or 3:8 for scenes 3 through 8. A start above 1 requires the preceding checkpoint. Disjoint comma selections are rejected because they break continuity. | |
| verify_resume_historyopt | BOOLEAN | true | Recommended ON: require every completed predecessor to match the current Plan's prompts, seeds, timing, source audio, model, and reference fingerprint. Turn OFF only to deliberately reuse the saved predecessor after changing the current Plan. Missing files, SHA-256 artifact integrity, checkpoint tensor shape, and internal metadata consistency are still verified. Changes to the predecessor itself are not applied retroactively. |
| source_audioopt | AUDIO | Legacy 0.4 full-AUDIO route. Leave this unconnected in a 0.5 workflow when source_timeline is connected; the two inputs are mutually exclusive. Use this socket only for an older workflow whose Audio Policy needs final source audio or Source reference=on. Loop Start saves it once as a path-backed run asset, so Current Shot, partial review, final assembly, and full-chain finishing do not need the AUDIO wired again. A short, completely silent placeholder is padded. | |
| external_contextopt | H3_CHAIN_EXTERNAL_CONTEXT | Optional output from MiniMax H3 Existing Video Context. When connected, scene 1 continues from that video's tail and its repeated head is trimmed exactly like every later scene. | |
| source_timelineopt | H3_SOURCE_TIMELINE | Primary 0.5 media wire from Source Timeline or Run Manager. It replaces the repeated full source_audio connection and stays lazy across recursive scenes. |
Outputs (3)
| Name | Type | Description |
|---|---|---|
| flow | H3_CHAIN_FLOW | Recursion control link. Connect directly to H3 Chain Loop End's flow input; do not route it through other nodes. |
| state | H3_CHAIN_STATE | Current chain state for Current Shot and the recursive body. |
| status | STRING | Starting scene, total scene count, and resume/padding status. |