Files
ComfyUI-H3-Continuum-Tiled/README.md
T

3.8 KiB
Raw Blame History

H3 Continuum Join 2.1

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 Prompt socket with Auto, Fixed, List, and Timeline parsing
  • Optional Clip N Prompt overrides follow chunks from 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.

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 V2 node generates 1 to 16 sequential chunks.
  • Sequence Prompt accepts one external Text (Multiline) input.
  • Prompt formats: Auto, Fixed, List, and Timeline.
  • 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), and Strong - 39 frames.
  • Seam Correction provides Off and Basic; Basic is 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