Skip to content

Getting Started

Ethanfel edited this page Sep 1, 2026 · 3 revisions

Getting started

This is the shortest path from installation to one assembled video.

1. Install

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.git

Restart 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.

2. Open an example

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.

3. Edit only the first-run controls

  1. Give Plan a short, unique run_name.
  2. Replace the sample scene prompts.
  3. Keep the example dimensions and duration.
  4. Keep Generation Profile on visual continuity and generated audio.
  5. Keep Review Gate enabled with one candidate.

Reusing run_name exposes the same checkpoint history. Use a new name for a new production.

4. Leave recovery nodes muted

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.

5. Queue and review

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.

6. Find the result

ComfyUI/output/h3_chains/<run_name>/
├── checkpoints/
├── segments/
└── final/

Use Run Manager or Checkpoint Manager instead of manually editing revision files.

Assemble without rendering

Open the same Plan and run_name, unmute Load Manifest → Assemble later, then queue only that Assemble node. The sampler body does not run.

Common problems

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.

Clone this wiki locally