Update README and add V3.2 sample workflows
This commit is contained in:
@@ -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**.
|
||||
|
||||

|
||||
|
||||
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.
|
||||
|
||||
Reference in New Issue
Block a user