Build a multi-scene MiniMax H3 video with one reusable sampling body. Review each scene, retry mistakes, resume interrupted runs, and assemble accepted scenes from disk.

Getting started · Choose a workflow · Troubleshooting · Full wiki

Version 0.5 status: main is the supported 0.5 release line. Saved 0.4 workflows and checkpoints remain supported.

Contex is the intentional public repository spelling.

What you get

| Goal | This pack provides | |---|---| | Make a longer story | A visual scene Plan drives one recursive H3 graph. | | Keep motion and sound connected | Guide and protected AV-prefix transitions. | | Direct each scene | Prompts, seeds, timing, pictures, motion video, and audio references. | | Work from existing footage | Source timelines, clip continuation, inpainting, and two-ended bridges. | | Iterate safely | Review, edit and retry, reroll, stop early, and atomic checkpoints. | | Recover the production | Resume, partial assembly, saved assets, and latent-to-PNG export. |

Quick start

From ComfyUI/custom_nodes:

git clone https://github.com/ethanfel/ComfyUI-MiniMaxH3-Contex-Loop.git

Restart ComfyUI, then:

Open a maintained workflow from example_workflows/.
Resolve missing model selections; models are not bundled.
Give Plan a unique run_name and edit its scene prompts. Use {wide shot|close-up} for alternatives. Each scene's Prompt alternatives control can derive a stable scene seed, keep an exact fixed seed, or randomize that scene on every queue. These choices never change sampler seeds, and the exact resolved choice is saved with the checkpoint.
Keep Guide and Generated audio for a simple first run.
Queue the graph. Preflight checks timing, media, references, compatibility, and resume state before H3 loads.
At Review Gate, approve, retry, reroll, or approve and stop. To compare several takes per scene, set its optional candidate_count above 1 (or convert it to an input and connect an INT node); Review Gate generates the candidates automatically and continues from the exact take you select.
Assemble the completed or partial manifest.

Version 0.5 expects a current ComfyUI build containing native Add Guide for MiniMax H3 from ComfyUI PR #15439. ffmpeg on PATH is preferred; ComfyUI's bundled PyAV can handle review and assembly when FFmpeg is unavailable.

Some examples need bundled media copied into ComfyUI/input/. See the asset guide.

Choose a workflow

| I want to… | Start here | |---|---| | Generate from text | T2V Normal | | Animate an opening image | I2V Normal | | Move between first/last images | FL2V Normal | | Use prompt-driven pictures | Ref2V Tagged | | Guide scenes with a source soundtrack | Ref2V Studio Tagged Source Audio | | Inpaint a fixed or tracked region | Masked Video Inpaint | | Inpaint with a picture-defined replacement | Ref2V Masked Video Inpaint | | Continue one existing clip | Masked AV Extension — Single Clip | | Continue several reviewed scenes | Masked AV Extension — Chain | | Generate the gap between two clips | Two-Clip Masked AV Bridge |

Choose Normal for the standard Plan and Scene Prompt Editor. Studio workflows add an optional experimental timeline interface without changing the generation graph. The wiki workflow chooser explains every maintained example and required asset.

How it works

Chain Policy → [Advanced] → [Legacy 0.4] → Plan
Source Timeline ───────────────────────────┘
                                             ↓
                           Preflight → Loop Start → Current Shot
                                                        ↓
                                      H3 conditioning → sample → decode
                                                        ↓
                                      trim → checkpoint → review → Loop End ─↺

Loop End manifest → Assemble

Only one scene passes through the sampling body at a time. The accepted predecessor supplies continuity to the next scene; completed media and recovery metadata remain on disk.

Find help by task

| Task | Guide | |---|---| | Install and run the first scene | Getting started | | Choose Cut, Guide, Hard AV, Soft AV, or audio behavior | Continuity and audio | | Use @tags, motion references, or Source Timeline | References and source media | | Inpaint, outpaint, extend, or bridge footage | Masked editing | | Retry, resume, recover, or assemble later | Review, resume, and recovery | | Upscale a completed checkpoint branch | Runs, review, and recovery | | Diagnose a problem | Troubleshooting | | Check where a feature came from | Feature origins | | Look up Plan fields and implementation details | Advanced reference |

Repository-native references remain available under docs/ and in the complete Plan format guide.

Checkpoint Manager identifies saved takes by scene and inferred branch, previews saved media and exact video/audio dependencies, and safely deletes inactive leaves one revision at a time. Its Plan and Source Timeline pass-throughs can remain connected in generation workflows, while its selected-manifest output launches a standalone deferred upscale loop with no source Plan. Each profile is isolated under upscaled/<profile>, and saving the large HQ latent is optional. The bundled chain-aware de-rope variant combines LBH 3D with MAINodes in the same second pass, protects recursive scene boundaries, restores the prior HQ Drift-Control tail, and returns recovered video/audio to the source clock before checkpointing. For whole-video SeedVR2 finishing, Full-Chain Latent Video Adapter instead re-decodes every selected H3 checkpoint into one cached, lossless, file-backed movie. It resolves scene overlaps before upscaling and uses a temporary disk-backed VAE output buffer, so the complete production never becomes one in-memory IMAGE tensor. Tagged and Scheduled Ref2VA also cache each active scene's native reference latents and compact Qwen presentation automatically; the upscale loop restores them from the checkpoint fingerprint without original reference-media wires. See Runs, review, and recovery.

Origins and license

This project began with NikoDemon80's H3 Motion Context and grew into a separate checkpointed production-loop pack. Original, adapted, inspired, integrated, and compatibility work is mapped in Feature traceability; licenses and exact upstream revisions are recorded in Third-party notices.

GPL-3.0. See LICENSE. Contributions are covered by CONTRIBUTING.md.