28b5b751a665fe47a026eb1c8222ab83ce859360
ComfyUI-H3-Continuum 2.1.4
Integrated long-form continuation for ComfyUI's native MiniMax H3 audio/video model.
H3 Continuum Sampler V2 runs N native H3 chunks through the proven V1 continuation core, keeps text/image preparation outside the H3-only sampling loop, captures AV latent state before decoding, and decodes/assembles the sequence only after all sampling is complete. All V1 node identifiers remain available.
V2 highlights
- One integrated N-chunk sampler node
- Native video/audio latent continuation with 5, 22, 39-frame and conservative Auto profiles
- One externally patched MODEL input with an isolated call-local clone per chunk
- Unique prompt conditioning cached before sampling
- One stable
Sequence Promptsocket with Auto, Fixed, List, and Timeline parsing - Optional
Clip N Promptoverrides followchunksfrom 1–16 and are collapsed by default - Local latent-preview toggle under
Settings > H3 Continuum > Preview - Optional V2.1 Basic seam correction after deferred decode; Off keeps the V2.0.2 path
- CPU-only adaptive cut, bounded color/luma guard, short motion-aware blend, and boundary-local audio crossfade
- No Video/Audio VAE decode between H3 chunks
- Full chunk latents stored on CPU; VRAM does not grow with accepted chunks
- Session resume, branch-safe reroll, atomic safetensors + JSON persistence
- Cumulative 24fps audio boundaries, preventing per-chunk rounding drift
- Single-allocation final image assembly and preflight RAM safety check
- External SageAttention, Sol-Attn, and Spectrum composition
- No global ComfyUI H3 monkey patch and no accelerator private-API dependency
- No additional pip dependencies
See README_JA.md for the complete guide.
Recommended graph
H3 UNET → SageAttention → Sol-Attn → LoRA → Spectrum
↓
CLIP / Video VAE / Audio VAE / Sampler / Sigmas
↓
H3 Continuum Sampler V2
↓
IMAGE + AUDIO → CreateVideo
V2 nodes
- H3 Continuum Sampler V2
- H3 Continuum Prompt Plan
- H3 Continuum Save Session
- H3 Continuum Load Session
- H3 Continuum Session Info
V1 compatibility nodes remain registered: Join, Finish, Assemble, Save State, and Load State.
Development checks
python -m compileall -q .
pytest -q
License
GPL-3.0-or-later. This package was independently implemented against public ComfyUI H3 runtime contracts. Optional accelerator source code is not bundled.
V2.1.4 Feature Summary
- One integrated
H3 Continuum Sampler V2node generates 1 to 16 sequential chunks. Sequence Promptaccepts one external Text (Multiline) input.- Prompt formats:
Auto,Fixed,List, andTimeline. - Optional per-clip prompt overrides remain collapsed until needed.
- Native video and audio latents pass directly between chunks without VAE decode/re-encode.
- Continuity presets:
Fast - 5 frames,Balanced - 22 frames(default), andStrong - 39 frames. - Seam Correction provides
OffandBasic;Basicis the default safe post-decode correction path. - Exact total duration and audio continuity are enabled by default.
- SageAttention, Sol-Attn, LoRA, and Spectrum remain external and composable.
- Spectrum Interop API v1 requests a two-step Actual prefix only when continuation context exists.
- Advanced continuation, State, Session, Prompt Plan, reroll, and diagnostic controls are collapsed by default.
- Existing advanced connections automatically reopen the Advanced section.
- V1 and auxiliary nodes remain load-compatible but are marked deprecated and moved to the Legacy category.
- Existing State and Session schemas, output ordering, and saved workflow node identifiers are preserved.
- Repository: https://github.com/ukr8b3g-cmyk/ComfyUI-H3-Continuum
Languages
Python
91.6%
JavaScript
8.2%
PowerShell
0.2%