Text-to-Image
MLX
MiniMax H3
Safetensors
English
apple-silicon
macos
image-to-image
image-editing
image-generation
Instructions to use devin-lai/MiniMax-H3-Image-mlx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use devin-lai/MiniMax-H3-Image-mlx with MLX:
# Download the model from the Hub pip install huggingface_hub[hf_xet] hf download devin-lai/MiniMax-H3-Image-mlx --local-dir MiniMax-H3-Image-mlx
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Atomic Chat
|
Download docs/cards/q4.md from devin-lai/MiniMax-H3-Image-mlx: direct link, hf CLI and curl.
- Browser
- Download file 3.58 kB
-
https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/resolve/main/docs/cards/q4.md
- Command line
-
hf download hf://devin-lai/MiniMax-H3-Image-mlx/docs/cards/q4.md
-
curl -L -o q4.md https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/resolve/main/docs/cards/q4.md
3.58 kB
| # MiniMax H3 Image MLX 路 Q4 affine core | |
| Fifty main DiT blocks and two token-refiner blocks use MLX affine 4-bit weight quantization, group size 64. This is the smallest core and has stronger observed lettering and detail drift. Inspect the comparisons before choosing it. | |
| Community adaptation by **Devin Lai**. Powered by MiniMax-H3-Image. | |
| [Start here: install and quick start](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx) 路 [Compare variants](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/blob/main/MODEL_INDEX.md) 路 [Evidence and limitations](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/blob/main/BENCHMARKS.md) | |
| ## Storage and historical performance 路 M5 Pro / 64 GiB | |
| | Measure | Result | | |
| |---|---:| | |
| | Q4 variant payload | **10.50 GiB** | | |
| | One historical warm product trial: denoising | 67.71 s | | |
| | Same trial: peak MLX allocation | 12.51 GiB | | |
| The variant payload excludes approximately 3.86 GiB of shared components and the roughly 62 GiB text encoder. The historical trial was one 2048 脳 2048, six-step product run with cached conditioning and resident weights, using online Q4 on an M5 Pro / 64 GiB. Denoising is not end-to-end time; MLX allocation is not total process or system memory and does not establish minimum RAM. This was not a fresh performance test of the downloadable export. Q4 changes images, especially detail and lettering, with no established speed advantage. [Method and full comparisons](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/blob/main/BENCHMARKS.md#historical-q8-and-q4-measurements). | |
| ## Download only this variant | |
| After installing the main runtime and obtaining the required access: | |
| ```bash | |
| h3-mlx download --variant q4 --model-dir models/q4 | |
| h3-mlx generate --model models/q4 \ | |
| --text-encoder models/q4/text_encoder \ | |
| 'An editorial photograph of a cobalt perfume bottle on pale stone' \ | |
| --seed 731 --output outputs/bottle.png | |
| ``` | |
| This fetches this variant, required shared components and the separately pinned | |
| native text encoder (roughly 62 GiB). It does not fetch other variants. Use | |
| `--text-encoder-path /path/to/text_encoder` to reuse an existing encoder. | |
| All image variants retain the six original PDD heads and native FP32 islands. | |
| The published compact format requires this runtime, not a generic Diffusers | |
| or mlx-lm loader. Tested on M5 Pro / 64 GiB; smaller Macs are unqualified. | |
| ## Model card and terms | |
| This is an inference port of `MiniMaxAI/MiniMax-H3-Image` at revision | |
| `6534ea1c979a5f8cb00c2bd1025d5ca4ee8d8901`, not a newly trained model. | |
| No new training dataset is introduced. Training provenance, potential biases, | |
| intended uses and upstream limitations remain those of the original model. | |
| See [modifications](MODIFICATIONS.md), [license](LICENSE) and [NOTICE](NOTICE). | |
| The MiniMax-H3-Image Community License Agreement and its acceptable-use policy | |
| apply, including territorial and commercial restrictions. The standard grant | |
| excludes the EU, UK, Republic of Korea and US. Access is subject to manual | |
| review; it does not provide separate permission. The upstream text encoder | |
| retains its own MiniMax H3 agreement. This is not an unrestricted open-source | |
| license or an official MiniMax endorsement. | |
| **Release:** v0.4.1 (v0.4.0 weights with download-count metadata). Access requests are reviewed manually under the retained license. | |
| The actual file manifest records exact sizes and SHA-256 hashes. | |
| [Report reproducible results or issues](https://huggingface.co/devin-lai/MiniMax-H3-Image-mlx/discussions) 路 [Follow devin-lai](https://huggingface.co/devin-lai) | |