cloud-worker

Tooling for running the MiniMax H3 open-weights video model (native stereo audio, 24 fps, 5–15 s, ~1 MP native) on RunPod GPU machines via ComfyUI.

Current test rig: 1x B200 (180 GB) pod — connection details in pod-info.txt.

Layout

• scripts/pod/ — runs on the pod
  • install-minimax-h3.sh — one-shot setup on a fresh pod (after install-comfy.sh)
  • download-weights.sh — all weight families → /workspace/minimax-h3/models
  • download-weights-tmpfs.sh — overflow files → /dev/shm (network-volume quota workaround; ephemeral, re-run after pod restart)
  • extra_model_paths.yaml — installed to /ComfyUI/extra_model_paths.yaml
  • start-comfyui.sh — headless ComfyUI in tmux on 127.0.0.1:8188
  • make-test-images.py — synthetic reference/first-frame images → /ComfyUI/input
• scripts/local/port-forward.sh — persistent tunnel localhost:8188 → pod ComfyUI panel (auto-reconnects)
• bench/minimax_bench.py — API-based benchmark harness (t2v / i2v / ref2v × duration × resolution × weight family); appends to bench/results.csv + bench/results.jsonl
• docs/WEIGHTS.md — which weights are downloaded, where, and which family
• docs/RESEARCH.md — model/ComfyUI findings, running without ComfyUI (SGLang / vLLM-Omni / diffusers), concurrency model, RunPod serverless
• docs/BENCHMARKS.md — measured results on the B200

Quick start

# tunnel to the ComfyUI panel (leave running)
scripts/local/port-forward.sh &
open http://localhost:8188

# one-off generation through the API
python3 bench/minimax_bench.py --task t2v --width 864 --height 480 --seconds 5

# smoke suite / full sweep
python3 bench/minimax_bench.py --suite quick
python3 bench/minimax_bench.py --suite sweep --prefix prunedint8_

On the pod, ComfyUI runs in tmux session comfyui (tmux attach -t comfyui), logs at /workspace/minimax-h3/comfyui.log.