Update README and add V3.2 sample workflows

This commit is contained in:
ukr8b3g-cmyk
2026-08-15 16:19:20 +09:00
parent 23b686e582
commit 55af89c711
4 changed files with 4106 additions and 0 deletions
+66
View File
@@ -10,6 +10,15 @@ https://github.com/user-attachments/assets/bfa8c683-fc9d-48f1-9cdb-477ca110cdf2
V3 delegates video and audio decoding to normal **ComfyUI Core VAE Decode nodes**. No model weights or third-party accelerator code are bundled.
## Sample workflows
- [Standard workflow](examples/workflows/MiniMax_H3_Continuum_V32.json) - quality-oriented `res_multistep` profile with Spectrum enabled.
- [Turbo workflow](examples/workflows/MiniMax_H3_Continuum_V32_turbo.json) - 8-step `euler` profile with Spectrum bypassed.
Download a JSON file and drag it onto the ComfyUI canvas. The examples use optional external custom nodes and local image/audio inputs; replace or bypass unavailable assets for your environment.
Turbo weights are available from [LightX2V MiniMax H3 Turbo](https://huggingface.co/lightx2v/Minimax-h3-Turbo/tree/main).
## Key features
- Raw paired video/audio latent continuation without decode/re-encode between chunks.
@@ -26,6 +35,16 @@ V3 delegates video and audio decoding to normal **ComfyUI Core VAE Decode nodes*
## Installation
### ComfyUI Manager
Open **ComfyUI Manager**, search for **H3 Continuum** or **Continuum**, and select **Install**.
![H3 Continuum in ComfyUI Manager](docs/images/comfyui-manager-h3-continuum.png)
Restart ComfyUI after installation, then search for **H3 Continuum Sampler V3.2** in the node menu.
### Manual installation
From `ComfyUI/custom_nodes/`:
```bash
@@ -123,6 +142,51 @@ Recommended safe defaults:
| Run Storage | Off for short tests; Save + Auto Resume for long runs |
| SageAttention | Auto when backend compatibility is unknown |
## H3 Continuum Sampler UI
The production node keeps normal generation controls visible and marks infrequent controls as native ComfyUI **Advanced** widgets. Most users only need the main controls.
### Main inputs and controls
| Group | Input or control | Purpose |
| --- | --- | --- |
| H3 pipeline | `model`, `clip`, `video_vae`, `sampler`, `sigmas` | Connect the normal MiniMax H3 MODEL, text encoder, Video VAE, sampler, and sigma schedule. |
| Prompt | `Sequence Prompt` | Fixed, List, or Timeline text for the complete Continuum run. |
| Keyframes | `first_frame`, `last_frame` | Optional I2VA, last-frame-conditioned, or FL2VA keyframes. |
| Reference images | `reference_image_1`, `reference_image_2`, `reference_image_3` | Up to three ordered Picture references. Bypassed inputs are ignored. |
| Reference audio | `reference_audio_1`, `reference_audio_vae` | Optional native H3 Reference Audio. Connect the Audio VAE only when Reference Audio is used. |
| Duration | `chunks`, `chunk_seconds` | Number of linked chunks and duration of each chunk. Start with `3 x 5.0` seconds. |
| Canvas | `width`, `height` | Output dimensions. Use values compatible with the current H3 Core path, normally multiples of 32. |
| Continuity | `continuity` | Number of previous raw frames carried into the next chunk. `Balanced - 22 frames` is the practical default. |
| Seed | `base_seed` | Base seed used to derive deterministic per-chunk seeds. |
Reference images and First/Last Frame are mutually exclusive. Reference Audio can be combined with either keyframe conditioning or Reference Image conditioning.
### Advanced controls
| Control | Default | Use |
| --- | --- | --- |
| Prompt Format | Auto | Detect Fixed, List, or Timeline prompts. |
| Audio Continuity | On | Carry raw audio context between chunks. |
| Report Detail | Basic | Select the amount of status and diagnostic text. |
| Regenerate From | Auto | Resume normally, or regenerate from a selected saved chunk. |
| `reroll_nonce` | 0 | Automatic Revision behavior. Positive values provide explicit legacy branch selection. |
| Strict Compatibility | On | Stop only on H3 contracts that are actually unsafe or unsupported. |
| Debug | Off | Enable additional troubleshooting output. |
| Show Preview | On | Show normal progress and preview information. |
| Run Storage | Off | Use `Save + Auto Resume` for long or interruptible runs. |
| Run Name | blank | Optional manual storage-name override. Automatic identification is used when blank. |
| Reference Size | Match Output | Choose practical output-area matching or larger identity preservation. |
### Outputs
| Output | Connect to |
| --- | --- |
| `video_latents` | One normal ComfyUI Core Video VAE Decode node. |
| `audio_latents` | One normal ComfyUI Core Audio VAE Decode node. |
| `assembly_plan` | **H3 Continuum Assemble V3**. |
| `status` | Core **Preview as Text** when a readable run report is needed. |
## Sequence Prompt
### Fixed
@@ -249,6 +313,8 @@ Experimental
Turbo + Spectrum is not the recommended default because local testing showed a higher risk of artifacts. Sol-Attn is also not part of the current recommended continuity profile.
Turbo LoRA files are available from [LightX2V MiniMax H3 Turbo](https://huggingface.co/lightx2v/Minimax-h3-Turbo/tree/main). The ComfyUI-specific FL2VA and Ref2VA variants can be selected in the upstream MODEL/LoRA chain; Continuum does not bundle or switch them automatically.
## Why Core Decode is external
Continuum owns sampling, continuation planning, chunk metadata, context trimming, audio alignment, exact duration, and final assembly.