ComfyUI MiniMax H3 Contex Loop

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:

1. Open a maintained workflow from example_workflows/.
2. Resolve missing model selections; models are not bundled.
3. Give Plan a unique run_name and edit its scene prompts.
4. Keep Guide and Generated audio for a simple first run.
5. Queue the graph. Preflight checks timing, media, references, compatibility, and resume state before H3 loads.
6. 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.
7. 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. 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.