Repository navigation
Getting Started
This is the shortest path from installation to one assembled video.
From ComfyUI/custom_nodes:
git clone https://github.com/seitanism/ComfyUI-H3-Motion-Context-MultiRef.git
git clone --branch nightly \
https://github.com/ethanfel/ComfyUI-MiniMaxH3-Contex-Loop.gitRestart ComfyUI. Use a current build with native Add Guide for MiniMax H3
support. ffmpeg is recommended; PyAV is the fallback where supported.
You need your own H3 diffusion model, text encoder, video VAE, and audio VAE.
Start with T2V Normal, or use the workflow chooser.
Select the four model files. Some examples also need media copied from
example_workflows/assets/ into ComfyUI/input/; see Example assets.
- Give Plan a short, unique
run_name. - Replace the sample scene prompts.
- Keep the example dimensions and duration.
- Keep Generation Profile on visual continuity and generated audio.
- Keep Review Gate enabled with one candidate.
Reusing run_name exposes the same checkpoint history. Use a new name for a
new production.
Most generation examples contain this grey recovery branch:
[MUTED] Load Manifest ──> [MUTED] Assemble later
Muted nodes are saved in the workflow but do not execute. Leave this pair muted while generating. The active Assemble node handles the normal final MP4.
Preflight checks the Plan before the large models load. After each saved take, Review Gate offers:
| Action | Result |
|---|---|
| Approve & continue | Accept the take and render the next scene. |
| Retry | Render the same scene again. |
| Reroll seed | Change only this scene's seed, then retry it. |
| Approve & stop | Keep a valid partial run and stop. |
After the last approval, Assemble writes the final MP4.
ComfyUI/output/h3_chains/<run_name>/
├── checkpoints/
├── segments/
└── final/
Use Run Manager or Checkpoint Manager instead of manually editing revision files.
Open the same Plan and run_name, unmute Load Manifest → Assemble later,
then queue only that Assemble node. The sampler body does not run.
| Symptom | Check |
|---|---|
| Missing Motion Context node | Install or update the MultiRef companion pack, then restart. |
| Queue pauses after one scene | Review Gate is waiting for a choice. |
| Opening image repeats in every scene | Keep Frame Gate active. |
| No final MP4 | Approve the last scene and confirm the active Assemble node is enabled. |
| Resume is rejected | Restore the original generation inputs or use a new run_name. |
Next: choose a workflow or read the node guide.