| # Release v0.4.1 |
|
|
| The main repository contains the MLX runtime, documentation, tests and |
| comparison records. Model files are split across four variant repositories and |
| a shared-components repository. Choose one variant; the downloader reuses the |
| shared components and the separately pinned upstream text encoder. Generated |
| images and visual comparisons are in a separate, manually gated example gallery. |
|
|
| [Browse the collection](https://huggingface.co/collections/devin-lai/minimax-h3-image-apple-silicon-mlx-6af64fcd11d7d7a3b17e11d8). |
|
|
| The component repositories use manual access review. Request access to your |
| chosen variant and the shared repository, read the applicable licenses and |
| sign in with `hf auth login`. Repository access does not itself grant rights |
| outside the upstream licenses. The agreements include territorial, commercial, |
| redistribution and acceptable-use conditions; their standard grant excludes the |
| EU, UK, Republic of Korea and US. The code is Apache-2.0; model weights retain |
| their respective MiniMax community licenses. No hosted inference service is |
| included. |
|
|
| [Quick start](README.md#quick-start) 路 [Model index](MODEL_INDEX.md) 路 |
| [Usage](USAGE.md) 路 [Validation](docs/VALIDATION.md) |
|
|
| ## Revisions and validation |
|
|
| `h3_mlx/model_index.json` pins the shared and variant repositories to immutable |
| commits. Each model repository also has a `v0.4.1` tag and a `files.json` |
| manifest with byte sizes and SHA-256 hashes. The uploaded component files were |
| checked against those manifests. The release validation records 53 local tests |
| and full-image packaging reproductions for packed12 and Q4; it does not claim |
| a fresh full-image Q8 reproduction or validation on another machine. |
|
|
| This patch adds root configuration files so Hugging Face can count downloads |
| through its normal server-side statistics. The weight and inference files are |
| unchanged. The previous `v0.4.0` tags and their pinned revisions remain available. |
|
|
| ## Preparing artifacts |
|
|
| For maintainers with the original model and the validated packed cache: |
|
|
| ```bash |
| python scripts/prepare_hf_release.py \ |
| --model /path/to/MiniMax-H3-Image \ |
| --packed-cache /path/to/validated/packed12-cache --quantize q4 |
| ``` |
|
|
| Staging is written under `.release/huggingface/`. Existing model and packed |
| files are linked rather than copied; optional quantized variants require |
| additional scratch space. Preserve original checkpoints and caches. The |
| publisher script uploads and verifies individual components before finalizing |
| the pinned catalog. It does not automatically approve access requests or post |
| announcements. |
|
|
