keys-2k-MiniMax-H3-Parallel-Two-DGX-Sparks

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

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

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

Or:

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:

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)

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:

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

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:

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)

---

Weights (not fully redistributed here)

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

Helpers: scripts/fetch_weights.sh
Upstream: Comfy-Org/MiniMax-H3, Kijai/MiniMax-H3_comfy.

---

Verify (agents must pass)

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

---

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)