Skip to content

feat: add minimax-h3 support - #1854

Merged
leejet merged 2 commits into
masterfrom
minimax-h3
Aug 4, 2026
Merged

feat: add minimax-h3 support#1854
leejet merged 2 commits into
masterfrom
minimax-h3

Conversation

@leejet

@leejet leejet commented Aug 4, 2026

Copy link
Copy Markdown
Owner

Summary

  • Add Minimax-H3 support

Related Issue / Discussion

N/A

Additional Information

T2AV example

.\bin\Release\sd-cli.exe -M vid_gen --diffusion-model  ..\models\diffusion_models\minimax_h3_fl2va-Q4_K_M.gguf --vae ..\models\vae\minimax_h3_video_vae_fp16.safetensors --audio-vae ..\models\vae\minimax_h3_audio_vae_fp32.safetensors --llm ..\models\text_encoders\qwen3vl_32b_minimax_h3-Q4_K_M.gguf -p "A cute American Shorthair silver tabby kitten surfs on a tropical ocean wave, riding a white surfboard with the clear text 'sd.cpp' on it. Cinematic tracking shot, realistic water, bright sunlight, smooth motion, and consistent character appearance. Add upbeat tropical surf-rock background music with cheerful drums and guitar, synchronized with the kitten’s energetic surfing." --cfg-scale 1.0 -v -W 864 -H 480 --diffusion-fa --offload-to-cpu --rng cpu --fps 24 --video-frames 56
t2av.mp4

Checklist

@stduhpf

stduhpf commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

So fast as always

@leejet
leejet merged commit ea7f0c8 into master Aug 4, 2026
9 checks passed
@stduhpf

stduhpf commented Aug 4, 2026

Copy link
Copy Markdown
Contributor

I was very confused because it was segfaulting for me when building diffusion model graph (specifically after calling split_av_latents()). Turns out that's just because I forgot to specify -M vid_gen. Maybe it would be nice to find a way to foolproof this.

danielhanchen added a commit to oobabooga/unsloth that referenced this pull request Aug 8, 2026
ensure_sd_cpp_binary hands back whatever find_sd_cpp_binary locates and only
probes that it runs, so an install upgraded from an older Studio kept serving
its pre-H3 managed sd-cli. The H3 load's only gate is SdCppEngine.version(),
which that binary passes, so the load reported ready and the failure surfaced
on the first generation, after the whole bundle had downloaded.

Gate the H3 path alone on the capability instead of a version string: upstream
added --ref-video and the other H3-only options in the same commit that added
MiniMax-H3 (leejet/stable-diffusion.cpp#1854, master-812-ea7f0c8), and the
release prebuilts report 'version unknown, commit unknown' because they are
built without a .git directory, so --help is the only usable signal. Image
generation keeps accepting any user-supplied build.

A stale copy under the installer-owned root is removed so the pinned prebuilt
reinstalls; a build the user supplied is left in place and the load fails
naming it, the same ownership split _usable_or_discard_managed makes. A --help
that cannot be read means 'cannot tell', never 'no H3'.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants