README.md

---
license: other
language:
  - en
tags:
  - minimax-h3
  - comfyui
  - dgx-spark
  - blackwell
  - video-generation
  - dual-gpu
  - parallel
  - power-pack
  - 2k
  - esrgan
library_name: comfyui
pipeline_tag: text-to-video
---

# keys-2k MiniMax-H3 — Parallel processing for **Two DGX Sparks**

**One-command pull · pinned quality stack · master-K0 dual-Spark parallel · ESRGAN “2K” · Spectrum audio fix · Contex-Loop / MultiRef · optional realism LoRA**

| | |
|--|--|
| **Docker (arm64, published)** | `ghcr.io/drowzeys/keys-2k-minimax-h3-parallel-two-dgx-sparks:0.31.1-pp20260811` (~16GB, Comfy+nodes; mount models) |
| **HF package** | this repo |
| **Power Pack** | [keys-DGX-Sparkticus-Ultimate-Power-Pack-Unleashed](https://github.com/drowzeys/keys-DGX-Sparkticus-Ultimate-Power-Pack-Unleashed-Dual-DGX-Sparks-Needed) |
| **Dual-serve foundation** | [tonyd2wild/ds4-h3-video-gen-factory](https://github.com/tonyd2wild/ds4-h3-video-gen-factory) (Tony) |

> Dual-serve DS4 + dual H3 on two DGX Sparks was made possible by **Tony (tonyd2wild)**.  
> This package is the **keyspark quality specialization** (ablit co-tenant profile + **sealed bf16 finals with stock int8-convrot TE** — heretic retired — + farm-mode dual parallel + 2K workflows).

---

## Why this exists

Agents and users often `git clone` **old** Spectrum / Motion Context / Comfy builds and lose:

- Spectrum **v0.2.1** audio fix (`offline_smoothing_replay=true`)
- Contex-Loop / MultiRef seam fixes  
- Legal native sizes for upscale-to-2K  
- Dual-node **master-K0** parallel spans  

This package **pins** the full integrated stack in a **Docker image** + **manifest** so the default path is the upgraded one.

---

## One-command pull

```bash
curl -fsSL https://huggingface.co/drowzeys/keys-2k-MiniMax-H3-Parallel-Two-DGX-Sparks/raw/main/scripts/one_command_pull.sh | bash
```

Or:

```bash
git clone https://huggingface.co/drowzeys/keys-2k-MiniMax-H3-Parallel-Two-DGX-Sparks
cd keys-2k-MiniMax-H3-Parallel-Two-DGX-Sparks
bash scripts/one_command_pull.sh
```

Pull Docker only:

```bash
docker pull ghcr.io/drowzeys/keys-2k-minimax-h3-parallel-two-dgx-sparks:0.31.1-pp20260811
# also tagged :latest
```

---

## What’s in the image (pinned)

| Component | Version / pin |
|-----------|----------------|
| ComfyUI | **0.31.1** |
| Spectrum MiniMax H3 | **0.2.1** (audio fix defaults) |
| Contex-Loop | **0.3.8** |
| Motion Context + MultiRef | pinned SHAs in `manifest/H3_STACK_MANIFEST.json` |
| Sol-attn Blackwell + Triton SolAttn | pinned |
| KJNodes (Sage) | 1.4.9 · `sageattention==1.0.6` |
| NKD Preview Tools | 3.3.0 |
| Launch flags | `--disable-pinned-memory --reserve-vram 48 --vram-headroom 10` |

**Not for quality:** Turbo / few-step LoRA graphs (present optional; leave off).

See **`manifest/H3_STACK_MANIFEST.json`** and **`scripts/verify_h3_stack.sh`**.

---

## 2K path (open weights)

Open MiniMax-H3 does **not** native 2K in one pass. This package’s production path:

```text
Native denoise  704 × 1280   (multiple of 32 — 720×1280 fails)
       ↓  RealESRGAN ×2 (inline on spans)
Delivery 2K    ~1408 × 2560
```

Parallelism: **master-K0** keyframes + **parallel FL2VA spans** on two Sparks  
(`h3-spans.py --kf-mode master-parallel --upscale`).

Workflow package: `workflows/anime_2k_bench/`  
Lab sample run `0811_012837`: ~**18.8 min** wall for ~4.8 s @ 704×1280 dual-node (co-tenant DS4).

---

## Dual DGX Spark — parallel H3

```bash
export HEAD=10.100.10.1 WORKER=10.100.10.5          # your fabric IPs
export MODELS_DIR=$HOME/keys-2k-minimax-h3-parallel/models

# weights once
bash scripts/fetch_weights.sh
# or: rsync -a /path/to/lab/h3-cotenancy/ComfyUI/models/ $MODELS_DIR/

# H3 on both nodes
bash scripts/run_dual_h3.sh

# quality 2K parallel bench
bash scripts/run_anime_2k_bench.sh
# optional realism LoRA (file in models/loras/):
REALISM=1 bash scripts/run_anime_2k_bench.sh
```

Single node smoke:

```bash
docker run --rm --gpus all --network host \
  -v $MODELS_DIR:/opt/powerpack-h3/ComfyUI/models \
  -v $HOME/Videos/h3-out:/opt/powerpack-h3/ComfyUI/output \
  ghcr.io/drowzeys/keys-2k-minimax-h3-parallel-two-dgx-sparks:0.31.1-pp20260811
# UI/API: http://<host>:8188
```

Compose: `compose/docker-compose.yml`

---

## Co-tenancy with DeepSeek-V4-Flash (Tony’s rule)

If running **DS4 + H3** on the same two Sparks:

1. **DS4 first** until `/v1/models` healthy  
2. **H3 second** (this image)  
3. Power Pack util **0.76** / 888k (or ≤ **0.85** hard cap)  
4. Teardown: **H3 → DS4**  
5. One heavy video job per Spark (`concurrency=2` = two boxes)

Full dual-boot recipe: Power Pack `deploy/keyspark/bringup.sh`.

---

## A/V glitch mitigations (baked into graphs)

| Fix | Setting |
|-----|---------|
| Spectrum speech stutter | `offline_smoothing_replay=true`, `audio_blend_weight=0` |
| Multishot seams | Motion Context / Contex-Loop / MultiRef |
| Long-gen hallucination | master-K0 short parallel spans (not one long gen) |

---

## Weights (not fully redistributed here)

Place under `models/` (bind-mount into the container):

| File | Role |
|------|------|
| `diffusion_models/minimax_h3_fl2va_pruned_bf16.safetensors` | FL2VA DiT — **FINALS (sealed)** |
| `diffusion_models/minimax_h3_ref2va_pruned_bf16.safetensors` | ref2va — **FINALS (sealed)** |
| `diffusion_models/minimax_h3_fl2va_pruned_int8_convrot.safetensors` | FL2VA DiT — draft tier only |
| `diffusion_models/minimax_h3_ref2va_pruned_int8_convrot.safetensors` | ref2va — draft tier only |
| `text_encoders/qwen3vl_32b_minimax_h3_int8_convrot.safetensors` | **STOCK int8-convrot TE** (sealed; heretic retired) |
| `vae/minimax_h3_video_vae_fp16.safetensors` | video VAE |
| `vae/minimax_h3_audio_vae_fp32.safetensors` | audio VAE |
| `upscale_models/RealESRGAN_x2plus.pth` | 2K upscale |
| `loras/h3-realism-people-t2v-i2v-r2v.safetensors` | optional realism |

Helpers: `scripts/fetch_weights.sh`  
Upstream: [Comfy-Org/MiniMax-H3](https://huggingface.co/Comfy-Org/MiniMax-H3), [Kijai/MiniMax-H3_comfy](https://huggingface.co/Kijai/MiniMax-H3_comfy).

---

## Verify (agents must pass)

```bash
bash scripts/verify_h3_stack.sh 10.100.10.1
bash scripts/verify_h3_stack.sh 10.100.10.5
```

Fails if Spectrum audio-fix default is wrong or core nodes are missing.

---

## Credits

| | |
|--|--|
| Dual-serve co-tenancy | **Tony / [tonyd2wild](https://github.com/tonyd2wild)** — [ds4-h3-video-gen-factory](https://github.com/tonyd2wild/ds4-h3-video-gen-factory) |
| Spectrum v0.2.1 audio fix | xmarre / ComfyUI-Spectrum-MiniMax-H3 |
| Motion Context | NikoDemon80 |
| MultiRef | seitanism |
| Contex-Loop | ethanfel |
| NKD Preview | Nekodificador |
| Sol / Sage / heretic | NVIDIA Sol-engine community · KJNodes · sakamakismile et al. |
| Packaging | keyspark / [@drowzeys](https://huggingface.co/drowzeys) Power Pack |

---

## License

- Package scripts/docs: see Power Pack repo  
- Model weights: **their respective licenses** (not all redistributed here)  
- ComfyUI and custom nodes: upstream licenses (GPL where applicable)