--- 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://: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)