| --- |
| license: other |
| license_name: minimax-h3-community-license |
| license_link: LICENSE |
| base_model: MiniMaxAI/MiniMax-H3 |
| base_model_relation: quantized |
| tags: |
| - text-to-video |
| - video-generation |
| - minimax-h3 |
| - quantized |
| - torchao |
| - nvfp4 |
| - int8 |
| - nf4 |
| - bitsandbytes |
| --- |
| |
| # MiniMax H3 — quantized weights (torchao NVFP4 / INT8, bitsandbytes NF4) |
|
|
| Quantized weights of [MiniMaxAI/MiniMax-H3](https://huggingface.co/MiniMaxAI/MiniMax-H3), made for the |
| **MiniMax H3 WebUI on Google Colab** (cell 2, `USE_HF_QUANT_CACHE`). They cut download time and VRAM |
| at start-up. **Unofficial** — not affiliated with, endorsed by, or supported by MiniMax. |
|
|
| > ⚠️ **Modified files.** Every weight file under `quantized/` is modified from the official weights |
| > by quantization. The text encoder is also split into two parts (layers 0–50 for prompt encoding, |
| > and layers 51–63 with `lm_head` for the optional prompt assistant). Nothing was retrained or fine-tuned. |
| |
| ## Contents |
| |
| | Path | Component | Method | Size | |
| |---|---|---|---| |
| | `quantized/transformer-nvfp4/` | DiT (T2V / I2V / FL2V) | torchao `NVFP4DynamicActivationNVFP4WeightConfig` (Linear layers; embeddings, refiner and in/out projections kept) | 18.5 GB | |
| | `quantized/transformer_ref-nvfp4/` | DiT for Ref2VA | same | 18.5 GB | |
| | `quantized/text_encoder-int8/` | Text encoder (Qwen3-VL-32B-Instruct), **layers 0–50** — what H3 uses for prompt encoding | torchao `Int8WeightOnlyConfig` (version 2, per-row; vision tower, embeddings, final norm kept) | 25.7 GB | |
| | `quantized/text_encoder-llm-tail/tail_int8.safetensors` | Text encoder **layers 51–63 + `lm_head`** (prompt assistant / LLM tab) | torchao `Int8WeightOnlyConfig` (version 2), flattened with `torchao.prototype.safetensors`; `lm_head` bf16 | 7.4 GB | |
| | `quantized/text_encoder-llm-tail/tail_nf4.safetensors` | same | bitsandbytes `Linear4bit` NF4 (double quantization, bf16 compute), plain state dict; `lm_head` bf16 | 4.5 GB | |
| |
| `.complete` in each folder records the component, quantization and torchao version. |
| `h3_upload_manifest.json` records the upload. The VAE, audio VAE and tokenizer are **not** included; |
| take them from the official repository. |
| |
| ## Requirements |
| |
| - `torchao` **0.18.x** and `safetensors` (serialized torchao tensors are tied to the torchao version recorded in `.complete`) |
| - NVFP4 needs an NVIDIA Blackwell GPU (sm_100 / sm_120). INT8 and NF4 also run on Ampere/Hopper. |
| - `bitsandbytes` for `tail_nf4` |
| - `diffusers` with the MiniMax H3 pipeline (the official repo's instructions) |
| |
| Measured on RTX PRO 6000 (G4) with the INT8 text encoder: the prompt assistant runs at |
| 7.7 tok/s with `tail_int8` (+7.4 GB VRAM) and 9.2 tok/s with `tail_nf4` (+4.5 GB). |
| |
| ## License |
| |
| These are **Model Derivatives of MiniMax H3** and are distributed under the |
| **MiniMax H3 Community License Agreement** (`LICENSE`, a copy of the original). By downloading or |
| using them you agree to its terms and its Acceptable Use Policy. No additional or different terms are |
| imposed on these files. |
|
|
| > MiniMax H3 is licensed under the MiniMax H3 Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved. |
|
|
| The text encoder of MiniMax H3 is **Qwen3-VL-32B-Instruct** (Qwen team, Alibaba Cloud), licensed under |
| the **Apache License 2.0** (`LICENSE-Apache-2.0`). The files in `quantized/text_encoder-int8/` and |
| `quantized/text_encoder-llm-tail/` are modified (quantized) versions of it. See `NOTICE`. |
|
|
| Main points of the Community License (read `LICENSE` for the binding text): |
|
|
| 1. **Territory** — no rights are granted to use, reproduce, modify, distribute or display the model |
| or its outputs in the **European Union, the United Kingdom, South Korea or the United States**. |
| 2. **Commercial use** — if your commercial products and services generate more than **USD 20 million** |
| in yearly revenue, you need separate prior written authorization from MiniMax (api@minimax.io). A commercial product or service that uses MiniMax H3 must **prominently display |
| "MiniMax H3"** in its user interface. |
| 3. **Outputs** — do not use the model or its outputs to improve any AI model other than MiniMax H3 and |
| its derivatives. |
| 4. **Acceptable Use Policy** — Exhibit A of the license applies to every use. |
|
|
| --- |
|
|
| ## 日本語概要 |
|
|
| [MiniMaxAI/MiniMax-H3](https://huggingface.co/MiniMaxAI/MiniMax-H3) の量子化済み重みです。 |
| **MiniMax H3 WebUI on Google Colab** のセル2（`USE_HF_QUANT_CACHE`）用に作りました。**非公式**で、MiniMax 社とは無関係です。 |
|
|
| > ⚠️ **改変したファイルです。** `quantized/` 以下の重みはすべて公式の重みを量子化したものです。 |
| > テキストエンコーダはプロンプト用の 0〜50 層と、プロンプト補助用の 51〜63 層＋`lm_head` に分けています。再学習はしていません。 |
| |
| | 場所 | 中身 | 方式 | |
| |---|---|---| |
| | `quantized/transformer-nvfp4/` | DiT（T2V / I2V / FL2V） | torchao NVFP4 | |
| | `quantized/transformer_ref-nvfp4/` | Ref2VA 用 DiT | torchao NVFP4 | |
| | `quantized/text_encoder-int8/` | テキストエンコーダ 0〜50 層 | torchao INT8 | |
| | `quantized/text_encoder-llm-tail/tail_int8.safetensors` | テキストエンコーダ 51〜63 層＋lm_head（bf16） | torchao INT8 | |
| | `quantized/text_encoder-llm-tail/tail_nf4.safetensors` | 同上 | bitsandbytes NF4 | |
| |
| VAE・音声 VAE・トークナイザは含みません（公式から取ります）。torchao は 0.18.x が必要です。NVFP4 は Blackwell 世代の GPU が必要です。 |
| |
| **ライセンス**: MiniMax H3 の派生物として **MiniMax H3 Community License Agreement**（`LICENSE`）で配布します。追加の条件は付けません。 |
| テキストエンコーダ（Qwen3-VL-32B-Instruct）部分は **Apache License 2.0**（`LICENSE-Apache-2.0`）です。詳細は `NOTICE`。 |
| |
| - **地域**: **EU・英国・韓国・米国**では、モデルと出力の使用・複製・改変・配布・表示の権利は与えられていません |
| - **商用**: 商用の製品・サービスの年間売上が 2,000 万米ドルを超える場合は、事前に MiniMax の書面許諾（api@minimax.io）が必要です。MiniMax H3 を使う商用の製品・サービスは UI に「MiniMax H3」を目立つように表示します |
| - **出力**: モデルや出力を、MiniMax H3 とその派生以外の AI モデルの改善に使ってはいけません |
| - **AUP**: ライセンスの Exhibit A（利用規定）が適用されます |
