Skip to content
,

Geiru Context Suite: Long MiniMax H3 Videos in ComfyUI Without Colour Drift

7–10 minutes
Woman in an editing suite holding a card reading GEIRU, hook long H3 video no colour drift

Chaining MiniMax H3 clips is the easiest way to make videos longer than a few seconds. The problem is that every new clip starts from the tail of the last one, so small colour and texture errors add up.

By clip 10 the image looks washed out, and by clip 20 it can fall apart.

Geiru Context Suite, a new ComfyUI node pack released on 12 November 2026, fixes that.

It keeps pulling every shot back toward the very first frame of clip 1, and it adds a windowed mode that renders a full minute or more in one go.

This guide covers what each node does, how to install it, the settings that work, the frame-count rules, and fixes.

TL;DR

  • What: a free (GPL-3.0) ComfyUI node pack for long MiniMax H3 videos: roycho87/geiru_context_suite, v1.0.0.
  • Main trick: Keystone writes clip 1’s first frame into the start of every shot, and Late Lock chooses the step where it kicks in.
  • Result (author’s test): colour drift over a 10-clip chain fell from 6.4 to 3.9 with Keystone, and to 2.9 with Keystone plus Late Lock.
  • Settings: Context head_frames 39 / drop_last 17, Anchoring tail_frames 56 / drop_first 17, Late Lock swap_step 4, Context Noise 0.8.
  • Needs: a ComfyUI build with MiniMax H3 support, plus one H3 Motion Context pack (NikoDemon80’s or seitanism’s MultiRef, not both). No model downloads.

Want the full picture? My complete MiniMax H3 guide covers install, files, settings and fixes in one place.

Why Long H3 Chains Drift

MiniMax H3 makes clips of a few seconds. To go longer, workflows such as Motion Context take the last frames of one clip and use them as the start of the next. That keeps motion smooth, but each clip is a copy of a copy:

  • Tiny colour shifts in clip 2 become the starting point for clip 3, and so on.
  • Fine texture (skin, fabric, foliage) gets softer every hand-off.
  • After 15-20 hand-offs, faces and scenes can break down completely.

Geiru’s idea is simple: keep a clean reference. Every shot also sees the very first frame of clip 1 (the “keystone”), and optionally the last frame of clip 1 (the “capstone”), so the model keeps getting reminded what the scene should look like.

The Nodes and What They Do

Node What it does Key inputs
Geiru Context Takes the start of the next shot from the end of the previous one head_frames, drop_last, drop_first, hold_audio, degradation_protection (on)
Geiru Anchoring Holds the tail of the previous shot so the join is smooth tail_frames, drop_first, drop_last, hold_audio, next_shot
Geiru Shot Counter Tracks which shot you are on shot_counter mode (increment, decrement, increment after accept, fixed, follow motion context), latent_prefix
Geiru Chain Run buttons: Approve, Run/Re-roll, Chain, Reset, Clear latents segments (0 = run until Stop)
Geiru Keystone Writes clip 1’s frame 0 into each shot’s start; can add a capstone from clip 1’s end enabled, placement, source_clip (1), latent_folder
Geiru Late Lock Sets the sampling step at which keystone/capstone latents are swapped in swap_step (4), slots (capstone back, keystone front, or both)
Geiru Context Noise Adds a little sampler noise to held frames so they do not freeze strength (0.8 in all tests)
Geiru Hybrid Windows Renders one long video in overlapping windows, repeating keystone and capstone in each context_length, context_overlap, switch_step, capstone_step, freenoise
Geiru Window Director Optional; steps through Hybrid Windows one window at a time approve, re-roll, rewind, blend

One more node, Geiru Prophecy, has moved to its own repository.

Install Geiru Context Suite

Step 1: Update ComfyUI

You need a ComfyUI build with MiniMax H3 support. Hybrid Windows also needs the newer H3 context-window nodes, so update if that node is missing. See how to update ComfyUI.

Step 2: Install the pack

Search geiru-context-suite in ComfyUI Manager, or clone it:

cd ComfyUI/custom_nodes
git clone https://github.com/roycho87/geiru_context_suite

No extra Python packages are needed.

Step 3: Install one Motion Context pack

For saving and loading latents between shots (and for Keystone’s latent_folder mode), install one of these, never both, because they use the same node names:

Step 4: Helper packs used by the examples

The example workflows also use ComfyUI-H3-Prompt-IDE, ComfyUI-KJNodes, ComfyUI-VideoHelperSuite, rgthree-comfy, ComfyUI-Custom-Scripts, ComfyUI-Easy-Use and ComfyMath. Open an example and use Manager’s Install Missing Custom Nodes.

Security note: if you install ComfyUI-Easy-Use, make sure you get the patched version. See our ComfyUI-Easy-Use vulnerability fix.

Step 5: Model files

Geiru adds no models. You use your normal MiniMax H3 files; our H3 guide lists them with their folders.

Frame-Count Rules

H3 works in blocks, so lengths are not free:

  • Clip length must be 17n + 5 frames: 5, 22, 39, 56, 73 … 192 …
  • Drop settings go in steps of 17.
  • For chains with sound, the recommended clip lengths are 141, 192, 243, 294 or 345 frames. Other lengths shift the held audio, and sound builds up down the chain.
  • The examples use 8-second clips of 192 frames. Clip 1’s capstone is frame 187.
  • Anchoring frames must outnumber Context frames (56 vs 39 in the defaults).

Workflow 1: Protected Clip Chain

Use this when you build a video clip by clip and want to approve each one.

  1. Load example_workflows/mad_clown_inventor_example.json (Context + Keystone + Late Lock), or noisy_clown_example.json to add Context Noise.
  2. Generate clip 1 as normal. This becomes the keystone source.
  3. Check that Keystone is enabled, source_clip is 1 and placement is keystone front.
  4. Set Late Lock swap_step to 4 (or the last quarter of your step count).
  5. Use the Geiru Chain buttons: Run a shot, Approve it, or Re-roll. Chain runs several in a row (segments 0 runs until you press Stop).
  6. At a scene cut, turn protection off for that shot. Cuts reset drift anyway, and the old keystone would fight the new scene.
  7. Join the clips with sane_clown_combiner.json, which trims the overlaps.

Workflow 2: Hybrid Windows (One Long Render)

Use this for a single continuous shot of a minute or more. ComfyUI renders overlapping windows and blends them, so memory stays at one window at a time.

  1. Load clown_coaster_example.json (60 seconds, 8 windows) or clowns_for_picard.json (widescreen).
  2. Set context_length and context_overlap. The example uses 124 / 39, about 5-second windows.
  3. Keep keystone and back capstone on, with switch_step 6 and capstone_step 4 (capstone_step must be below switch_step).
  4. Leave freenoise off. Turn context noise on at 0.8 if held frames look frozen.
  5. Write one prompt per window. If you change the total length, the prompts will no longer line up with the windows.
  6. Add Geiru Window Director to approve, re-roll, rewind or blend each window as it renders.

The coaster example is about 1 MP for a full minute, which is a heavy render. Lower the resolution if you run out of memory. The author’s bigger demo was 3,031 frames at 960×544 in 16 windows of 226 frames, with a 39-frame overlap and 8 steps per window.

Recommended Settings

Node Setting Value
Geiru Context head_frames / drop_last 39 / 17
Geiru Anchoring tail_frames / drop_first 56 / 17
Geiru Late Lock swap_step 4 (or last quarter of steps)
Geiru Context Noise strength 0.8
Hybrid Windows context_length / overlap 124 / 39 (example)
Hybrid Windows switch_step / capstone_step 6 / 4
Hybrid Windows freenoise off
Clip length frames 141, 192, 243, 294 or 345

How Much It Helps

These are the author’s own tests, not independent ones:

Test No protection Keystone Keystone + Late Lock
10-clip chain, colour drift from clip 1 (lower is better) 6.4 3.9 2.9
  • 50-clip chain (5 min 20 s, four scenes): the unprotected chain fell apart by clip 20. The protected one stayed clean, if slightly darker.
  • Single render: a 2 min 6 s roller-coaster video from Hybrid Windows, plus a 544×960 talking-portrait demo.

vs Other H3 Long-Video Tools

Tool Best for Our guide
Geiru Context Suite Stopping colour drift in long chains; minute-long single renders This page
H3 Continuity Studio Keeping characters and scenes consistent across a film H3 Continuity Studio
H3 Extender Turning one reference image into several connected clips H3 Extender
H3 Max Extend node Official extend, recast and reframe tools H3 Max editing nodes

They work together. You can plan a film with Continuity Studio and use Geiru to stop the long shots from drifting.

Troubleshooting

Problem Fix
Duplicate or conflicting Motion Context nodes You installed both Motion Context packs. Remove one.
Geiru Hybrid Windows missing or red Update ComfyUI to a build with H3 context windows.
Audio gets louder or echoes down the chain Use a recommended clip length (141, 192, 243, 294, 345) and the default drop settings.
Frame count error Lengths must be 17n + 5, and drops must be multiples of 17.
Static shot slowly darkens A known limit on fully locked-off shots, noted by the author; the texture still holds.
Next scene looks like the old scene Turn Keystone off at scene cuts.
Cannot restore latent 0 Happens without the model input or without Geiru Context. Use the 17 + 22 join cut instead.
Prompts out of sync in the coaster example You changed the total length. Keep one prompt per window.
Out of memory in Hybrid Windows Lower the resolution or the window length.

FAQ

Is Geiru Context Suite free?

Yes. It is open source under GPL-3.0 and adds no paid models.

Does it work with other video models?

It is built for MiniMax H3 and its block sizes. It is not documented for Wan, LTX or others.

How much VRAM does it need?

The repo gives no figure. It adds little on top of normal H3 use, and Hybrid Windows keeps memory to one window at a time, so your usual H3 setup should work at the same resolution.

Can I use it in an old workflow?

Yes. Add Keystone and Late Lock to an existing Motion Context chain, or start from the example workflows.

Sources

Free weekly email

Get new AI guides every week

One short weekly email with our newest local AI, ComfyUI and AI tool guides. No spam, no pop-ups, just the good stuff.

Free. Unsubscribe anytime in one click. We only use your email to send this newsletter. See our privacy policy.

Woman in an editing suite holding a card reading GEIRU, hook long H3 video no colour drift