docs: add ComfyUI quick start and badge

Add a ComfyUI quick-start guide for 4-, 6-, and 8-step workflows and a linked SVG badge.

README.md

@@ -10,10 +10,13 @@ tags:
 - audio-video
 - minimax-h3
 - turbo
+- comfyui
 ---
 
 # MiniMax-H3-Turbo
 
+[![ComfyUI: 4 / 6 / 8 steps](assets/comfyui-badge.svg)](https://github.com/wuli-art/MiniMax-H3-Turbo-ComfyUI)
+
 Fixed-step MiniMax-H3 checkpoints for text-to-video with audio and first-frame-to-video with audio. This repository contains three variants:
 
 - `turbo-4step/`: four-step LoRA with fused video and audio output projections.
@@ -34,6 +37,52 @@ containing H.264 video and AAC audio; no separate WAV is written.
 
 Compare **Wuli at 4, 6 and 8 steps** with Larry v4, LightX2V, FlashGen, DMAD, PAI and the original MiniMax-H3 at 50 steps. The demo includes **9 prompts, 11 configurations and 99 videos**, with synchronized playback, step-count filters, side-by-side comparisons and selectable audio.
 
+## ComfyUI
+
+Use the [MiniMax H3 Turbo ComfyUI node pack](https://github.com/wuli-art/MiniMax-H3-Turbo-ComfyUI) to generate video and audio with **4, 6, or 8 steps** and save them together as one MP4.
+
+### 1. Install the nodes
+
+Use a local ComfyUI installation with CUDA-enabled PyTorch. Clone the node pack into `ComfyUI/custom_nodes/` and install its dependencies with the **same Python environment that runs ComfyUI**:
+
+```bash
+cd /path/to/ComfyUI/custom_nodes
+git clone https://github.com/wuli-art/MiniMax-H3-Turbo-ComfyUI.git
+cd MiniMax-H3-Turbo-ComfyUI
+python -m pip install -r requirements.txt
+```
+
+For Windows Portable, run the dependency command from the `ComfyUI_windows_portable` directory using its embedded Python:
+
+```powershell
+.\python_embeded\python.exe -m pip install -r .\ComfyUI\custom_nodes\MiniMax-H3-Turbo-ComfyUI\requirements.txt
+```
+
+Restart ComfyUI. The node pack requires `diffusers==0.40.0`, `transformers>=4.57.0`, and `peft>=0.17.0`; its `requirements.txt` installs the required packages. When updating an existing installation, install the requirements again before restarting.
+
+### 2. Load a workflow
+
+Download a workflow JSON below and drag it into ComfyUI:
+
+| Variant | Text-to-video workflow | Selection |
+| --- | --- | --- |
+| 4 steps | [t2va_4step.json](https://raw.githubusercontent.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/main/example_workflows/t2va_4step.json) | `steps = 4` |
+| 6 steps | [t2va_8step.json](https://raw.githubusercontent.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/main/example_workflows/t2va_8step.json) | Change `steps` to `6` |
+| 8 steps | [t2va_8step.json](https://raw.githubusercontent.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/main/example_workflows/t2va_8step.json) | `steps = 8` |
+
+The workflows connect **MiniMax H3 Turbo Generate** to **MiniMax H3 Turbo Save MP4**. The default generation settings are `seed = 42`, `num_frames = 124`, `height = 768`, and `width = 1344`.
+
+### 3. Generate a video with audio
+
+1. Select `steps` and enter your scene and desired sound in `prompt`.
+2. Leave `model_root` empty for automatic downloads. Keep `components_root` set to `MiniMaxAI/MiniMax-H3`.
+3. For text-to-video, leave `first_frame` and `last_frame` disconnected.
+4. Run the workflow. The first run downloads and loads the selected Turbo weights and official components. The save node writes a 24 fps H.264/AAC MP4 to ComfyUI's output directory.
+
+For frame-conditioned generation, use [fl2va_4step.json](https://raw.githubusercontent.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/main/example_workflows/fl2va_4step.json) or [fl2va_8step.json](https://raw.githubusercontent.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/main/example_workflows/fl2va_8step.json). Select your image in **Load Image** and connect it to `first_frame`; connect a second **Load Image** node to `last_frame` when a final frame is also provided. For 6 steps, use the 8-step example and change `steps` to `6`.
+
+See the [node pack README](https://github.com/wuli-art/MiniMax-H3-Turbo-ComfyUI#readme) for installation and usage details, or [open an issue](https://github.com/wuli-art/MiniMax-H3-Turbo-ComfyUI/issues) for ComfyUI-specific problems.
+
 ## Requirements
 
 The demo was tested with Diffusers 0.40.0 and huggingface_hub 1.27.0. Install a CUDA-enabled PyTorch build compatible with your driver, then install the remaining packages. Only these two versions are pinned: