File size: 2,590 Bytes
c138412
3da88e3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
c138412
3da88e3
 
 
 
 
c138412
 
 
 
3da88e3
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
# 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.