Skip to content

feat(gallery): add minimax-h3-ref2va-q4 - the Ref2VA partition, verified coherent - #11439

Merged
mudler merged 1 commit into
masterfrom
feat/minimax-h3-ref2va-gallery
Aug 10, 2026
Merged

feat(gallery): add minimax-h3-ref2va-q4 - the Ref2VA partition, verified coherent#11439
mudler merged 1 commit into
masterfrom
feat/minimax-h3-ref2va-gallery

Conversation

@localai-bot

Copy link
Copy Markdown
Collaborator

MiniMax-H3 ships two independently-served DiT partitions and each refuses the other's tasks. The gallery had only the FL2VA one (t2va + fl2va). This adds the Ref2VA checkpoint — the one that serves reference conditioning.

It's a genuinely separate 19.9 GB download rather than a mode flag, which is why it needs its own entry. Everything except the DiT is shared with the FL2VA entry.

Why Q4_K_M, explicitly

The NVFP4 Ref2VA weights render a multicolour patch grid. Three upstream investigations attributed that to the ref2va reference-row path before anyone varied the checkpoint; on Q4_K_M the identical code renders coherently:

measure result scale
period-16 seam 1.13 1.15-1.19 clean / 2.28 broken
VAE-input latent adj-cell cosine 0.8526 0.06 white / 0.789 real encode / 0.89+ coherent

The description warns users off NVFP4 rather than leaving that dead end for them to rediscover.

Modalities

known_input_modalities carries image, video and audio (the FL2VA entry has only text+image). The ABI's ref2va slots are ref_image (PPM), ref_video (a directory of frame_%06d.ppm) and ref_audio (16-bit PCM WAV), and checkPartitionConditioning already routes all three.

Checksum verified two ways

  • sha256 computed over the downloaded 19,864,208,064-byte file
  • HuggingFace x-linked-etag for the same URI

Both 17925612821ea3037ffaf5f7f9789f5460e87025385bd45e9ec6c7d536684d56.

Not verified

An end-to-end render through LocalAI itself. The render was proven with vllm.cpp's own driver on this exact checkpoint (512x512/124f, coherent office scene, no grid). The backend drives the same library seam, but has not been exercised with these weights.

…ied coherent

MiniMax-H3 ships two independently-served DiT partitions and each refuses the
other's tasks. The gallery had only the FL2VA one (t2va + fl2va); this adds the
Ref2VA checkpoint, which is what serves REFERENCE conditioning - a reference
image, a reference clip, or reference audio prepended as their own blocks.

It is a genuinely separate 19.9 GB download, not a mode flag, which is why it
needs its own entry. Everything except the DiT is shared with the FL2VA entry.

Q4_K_M specifically, and the description says why: the NVFP4 Ref2VA weights
render a multicolour patch grid. Three upstream investigations attributed that to
the ref2va reference-row path before the checkpoint was varied; on Q4_K_M the
identical code renders coherently (period-16 seam 1.13 against 2.28 broken,
VAE-input latent adjacent-cell cosine 0.8526 against 0.06 white). Pointing users
at NVFP4 here would hand them that dead end.

known_input_modalities carries image, video AND audio, unlike the FL2VA entry:
the ABI's ref2va slots are ref_image (PPM), ref_video (a directory of
frame_%06d.ppm) and ref_audio (16-bit PCM WAV), and the backend's
checkPartitionConditioning already routes all three.

Checksum verified two ways: sha256 computed over the downloaded 19,864,208,064
byte file, and HuggingFace's x-linked-etag for the same URI - both
17925612821ea3037ffaf5f7f9789f5460e87025385bd45e9ec6c7d536684d56.

Not verified here: an end-to-end render through LocalAI itself. The render was
proven with vllm.cpp's own driver on this exact checkpoint; the backend path is
the same library seam but has not been exercised with these weights.

Assisted-by: Claude Code:claude-opus-5 [ClaudeCode]
@mudler
mudler merged commit da6fc8f into master Aug 10, 2026
5 of 9 checks passed
@mudler
mudler deleted the feat/minimax-h3-ref2va-gallery branch August 10, 2026 08:34
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants