MiniMax-H3 Low-Bit GGUF Laboratory
Reproducible Q1, IQ2, IQ3 and adaptive mixed-precision experiments for the
approximately 20B-parameter pruned MiniMax-H3 FL2VA denoiser. This repository is
a validation-first extension of the existing QF2 mixed-IQ1 release. The Qwen3-VL
text encoder and video/audio VAEs remain separate companion files.
The repository owner confirms separate written MiniMax authorization covering
this publication. That authorization is not sublicensed here. Downstream users
remain responsible for the official licence and any location-specific terms.
Planned and active variants
| Family | Variant | Purpose |
|---|
| 1-bit | UD-IQ1_M-QF, UD-IQ1_S-QF | Existing validated mixed-IQ1 baselines |
| 1-bit experiment | UD-Q1_0-QF | True Q1_0 codec test under QF protection; rejected for severe visual corruption |
| 2-bit | IQ2_XXS, IQ2_S, UD-IQ2_S-QF | IQ2_XXS rejected; IQ2_S experimental; QF-protected UD-IQ2_S-QF recommended |
| 3-bit | IQ3_XXS, IQ3_S | IQ3_XXS experimental; IQ3_S under quality/audio review |
| adaptive | AQUA-v1 | Activation-Quantile Utility Allocation across Q1/IQ1/IQ2/IQ3/Q4/Q5/Q8 |
Only variants that pass the stated audiovisual gates will be placed in the
public generation studio. Rejected experiments remain documented in
RESULTS.md; their failure does not get laundered into marketing terminology.
AQUA-v1
AQUA means Activation-Quantile Utility Allocation. It reads an H3 activation
importance matrix, normalises importance within architectural roles, starts from
role-specific precision floors, and greedily spends a target bit budget on the
upgrade with the largest activation-weighted reconstruction utility per added
bit.
AQUA-v1 is a new deterministic mixed-precision allocation policy. It composes
existing GGML block codecs rather than pretending to have invented a new binary
codec. Its exact tensor decisions, estimated bit budget and rules are stored in
manifests/AQUA-v1-policy.json.
Current generated policy target:
- eligible parameters:
19,267,584,000
- requested estimated bpw:
3.15
- achieved estimated bpw:
3.14875
- hard-protected final blocks: 47-49 at Q8_0
- allocated codecs: Q1_0, IQ2_S, IQ3_S, Q4_K, Q5_K and Q8_0
Reproduction
1python3 scripts/aqua_policy.py \
2 --gguf minimax_h3_fl2va_pruned-Q8_0.gguf \
3 --imatrix minimax_h3_fl2va_pruned-qf.imatrix \
4 --target-bpw 3.15 \
5 --manifest AQUA-v1-policy.json \
6 --rules-file AQUA-v1.rules
7
8scripts/build_variant.sh IQ2_S
The build wrapper uses atomic .part outputs, SHA-256 manifests, an H3
importance matrix and a post-build GGUF inventory audit. See RESULTS.md before
downloading any experimental artifact.
Lineage
- base:
MiniMaxAI/MiniMax-H3 revision 6818f6c32d12b210915e44ad56a4228c2608f160
- pruned FL2VA lineage:
Comfy-Org/MiniMax-H3 revision 014cd40f7e177756c6b2473c0d93b1c89a790dd2
- Q8 conversion source:
unsloth/MiniMax-H3-GGUF revision 9ee8213df85a2fcec53dec8c651a0fb1e821674a
- runtime/converter:
unslothai/stable-diffusion.cpp revision 13b9d92b5e9a1563536c9c980e700470f9ab6702
- calibration imatrix SHA-256:
6ce80c23f85d50cc170b1bfafa681811e5ef26590757f1c31540485b502c67a2
These are unofficial derivatives and are not endorsed by MiniMax, Comfy-Org or
Unsloth. Read LICENSE, NOTICE and RESULTS.md before use.
Recommended new model
UD-IQ2_S-QF is the recommended new 2-bit branch after matched fox and motorcycle holdouts. Use the 4-step website profile; see RESULTS.md for the exact audio limitation and hashes.
