Instructions to use nanguoyu/MiniMax-H3-minirun with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- Diffusers
How to use nanguoyu/MiniMax-H3-minirun with Diffusers:
pip install -U diffusers transformers accelerate
import torch from diffusers import DiffusionPipeline # switch to "mps" for apple devices pipe = DiffusionPipeline.from_pretrained("nanguoyu/MiniMax-H3-minirun", dtype=torch.bfloat16, device_map="cuda") prompt = "Astronaut in a jungle, cold color palette, muted colors, detailed, 8k" image = pipe(prompt).images[0] - MLX
How to use nanguoyu/MiniMax-H3-minirun with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] huggingface-cli download --local-dir MiniMax-H3-minirun nanguoyu/MiniMax-H3-minirun
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
MiniMax-H3-minirun
Weights from the MiniMax H3 release and from community repacks of it, pinned by
revision in the table below, repacked byte for byte into the container format
Minirun reads. Minirun streams a model from an external SSD on Mac
and iPhone through a memory budget you set, rather than loading it into memory,
so the model does not have to fit in the machine. The reader is open source:
Sources/StorageCore/Container/ in
nanguoyu/minirun-app.
What this is
A byte-preserving repack with AdaLN pruning and precomputed modulation. Nothing here was quantized, requantized, retrained or distilled:
- the quantized matrices are the upstream affine 8-bit codes, scales and biases at group 64, copied verbatim and only regrouped into new files;
- the dense tensors are the upstream bf16 and fp32 bytes, copied verbatim;
- the per-block AdaLN projections and the time embedder are absent, and precomputed modulation caches for a 50-step base schedule and a 4-step Turbo schedule stand in their place. Removing whole tensors leaves every tensor that remains byte-identical.
Every byte of weight data here is a byte of one of the sources below, at the pinned revision, in a different order. The exceptions are container headers, alignment padding, the manifests, and the modulation caches, which were computed from the official bf16 AdaLN and time-embedder tensors.
MODIFICATIONS.md states the changes in full and
NOTICE carries the attribution.
Contents
112 directories, 778 data files, 64.0 GB in total, plus one manifest per directory giving each file's shape, element width, offsets and digests.
| Kind | Files | Size |
|---|---|---|
blob |
127 | 14.32 GB |
modulation-cache |
4 | 1.96 GB |
quantized-blob |
189 | 8.90 GB |
tile-container |
458 | 38.79 GB |
Run it with Minirun
Get the app. On a Mac, download Minirun.dmg. On an iPhone,
build it from nanguoyu/minirun-app; the README there has the
steps.
Point it at this repository. In Settings → Storage, use Add a folder… to register a folder on an external NVMe drive. In Settings → Models, open Find Models, select this repository and press Download -- or point Minirun at a copy you already have. Run Verify all files.
What to expect. Minirun downloads, verifies and stores this container today, and shows it as Container ready; a runtime for it is on the way. The two other containers published this way, Kimi K3 and DeepSeek V4 Flash, are chat models and run now.
| On disk | 64 GB |
| MacBook Pro (M1 Pro, 32 GB, USB4 enclosure) | download, verify, store |
| iPhone 16 Pro (USB 3 port, powered dock) | download, verify, store |
Copy and verify speeds change with the drive, the cable and the budget; the enclosure and cable matter more than the SSD — USB4 against a 10 Gb/s hub is about 3× on the same bytes — and the iPhone needs a powered dock.
Requirements. An Apple-silicon Mac on macOS 15 or later; an iPhone 15 Pro or later on iOS 18 or later; an external NVMe drive with room for the model.
minirun.dev · Docs · This model · GitHub
Provenance
| Source | Revision | Contributes | License |
|---|---|---|---|
pipenetwork/MiniMax-H3-MLX-8bit |
3ac52081470b0488921c3ec3ba84a39097bf2361 |
diffusion transformer, affine 8-bit, group 64 | MiniMax H3 Community License Agreement |
ddalcu/MiniMax-H3-FL2VA-MLX-Serve-8bit |
64314cde0ac6d90f132bc94ae58e0c82f77396c6 |
text encoder, affine 8-bit, group 64, 50 layers | Apache License 2.0 (Qwen3-VL-32B) |
MiniMaxAI/MiniMax-H3 |
6818f6c32d12b210915e44ad56a4228c2608f160 |
video VAE (fp32), audio VAE, configs, tokenizer, and the bf16 AdaLN and time-embedder tensors the modulation caches were computed from | MiniMax H3 Community License Agreement |
lightx2v/Minimax-h3-Turbo |
b65e359c0d128b3c5e08e0f5bf2791b794378588 |
4-step Turbo LoRA | Apache License 2.0 |
Kijai/MiniMax-H3-TAE |
a213ac8bf2f148b4f32372279a7f207846978900 |
tiny approximate video decoder | Apache License 2.0 |
License
The model weights redistributed here are governed by the MiniMax H3 Community
License Agreement, reproduced verbatim in LICENSE and copied
unmodified from MiniMaxAI/MiniMax-H3 at
revision 6818f6c32d12b210915e44ad56a4228c2608f160.
“MiniMax H3 is licensed under the MiniMax H3 Community License Agreement, Copyright © 2026 MiniMax. All Rights Reserved.”
That is the notice Section III.4 of the Agreement requires to accompany every
distribution; NOTICE carries it, together with the attribution for
every source in the table above.
Two components carry a licence of their own in addition. The 4-step Turbo LoRA and the tiny approximate video decoder are released by their authors under the Apache License 2.0, and both are also derivatives of the MiniMax H3 Works, so their use remains subject to the Agreement as well. The two licences apply together, not in the alternative. The Agreement separately records that the H3 encoder is Qwen3-VL-32B under the Apache License 2.0.
The Agreement in LICENSE is the governing text. Nothing in this
card is a substitute for reading it, and it carries obligations -- among them a
territorial restriction, an acceptable-use policy, and a separate authorization
requirement for large commercial users -- that this summary does not restate.
- Downloads last month
- -
Quantized
Model tree for nanguoyu/MiniMax-H3-minirun
Base model
MiniMaxAI/MiniMax-H3