Repository navigation
Compatibility and Migration
The current nightly branch expects a ComfyUI build with native Add Guide for MiniMax H3
from PR #15439.
Install the maintained MultiRef companion pack beside Contex Loop. It provides the public Motion Context node used by the supplied workflows.
Guide, Latent Guide, and Detail Guide prefer that native path. AV-prefix and masked-editing operations use the per-token video/audio mask API merged from PR #15375.
Older supported builds receive scoped compatibility only when the relevant operation executes. Ordinary Guide workflows do not activate AV-mask fallback code.
- NikoDemon80's original H3 Motion Context pack may coexist with Contex Loop; its public node IDs are distinct. The supplied current workflows use MultiRef.
- Known H3-Multishot payload hooks are retained.
- Known SolAttn layout wrappers are retained.
- Unknown H3 layout or payload wrappers produce a clear error instead of being silently replaced.
- Patch Priority is for a recognized legacy load-order conflict, not a general performance or quality setting.
Opening or resuming a 0.4 workflow does not require migration. Version 0.5 retains node IDs, existing positional input/output order, legacy Plan widgets, manifests, checkpoints, and generic hash fallback.
Migration is recommended because it makes policies and Preflight explicit.
| 0.4 mode | Final | Source reference | Generated continuity |
|---|---|---|---|
generated_audio |
Generated | Off | On |
source_track |
Source | On | Off |
source_plus_timeline |
Source | On | On |
| 0.4 setting | 0.5 preset |
|---|---|
| Guide with zero context | Cut |
guide |
Guide |
masked_av |
Hard AV |
audio_feathered_av |
Soft AV |
feathered_av |
Expert compatibility override |
Tone Carry Guide, Latent Guide, Detail Guide, and Detail AV are new opt-in choices and do not alter a migrated workflow automatically.
Back up a custom workflow, then run from the custom-node repository:
python tools/migrate_v05_workflows.py --check /path/to/workflow.json
python tools/migrate_v05_workflows.py /path/to/workflow.jsonWith no path, the tool checks or migrates maintained active examples. It is idempotent and does not renumber existing nodes or replace node types.
Version 0.4 often repeated a complete AUDIO value into several nodes. Version 0.5 registers it once:
Load Video / Load Audio → Source Timeline → Loop Start → Current Shot
└───────────→ Preflight / Plan Studio
Loop End manifest → Assemble
The descriptor travels through state and manifests; path-backed media stays lazy. Legacy full-AUDIO fan-out and direct media paths remain accepted.
- FFmpeg is preferred, with PyAV fallback for review and assembly.
- Release-versioned web modules reduce stale frontend code after updates.
- If UI code still appears stale, reload the browser before clearing all site data.
See Troubleshooting for symptoms and corrective actions.