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. 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 ## Key features
- Raw paired video/audio latent continuation without decode/re-encode between chunks. - 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 ## 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/`: From `ComfyUI/custom_nodes/`:
```bash ```bash
@@ -123,6 +142,51 @@ Recommended safe defaults:
| Run Storage | Off for short tests; Save + Auto Resume for long runs | | Run Storage | Off for short tests; Save + Auto Resume for long runs |
| SageAttention | Auto when backend compatibility is unknown | | 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 ## Sequence Prompt
### Fixed ### 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 + 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 ## Why Core Decode is external
Continuum owns sampling, continuation planning, chunk metadata, context trimming, audio alignment, exact duration, and final assembly. Continuum owns sampling, continuation planning, chunk metadata, context trimming, audio alignment, exact duration, and final assembly.
Binary file not shown.

After

Width:  |  Height:  |  Size: 15 KiB

File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff