# Model and repository index

The Hugging Face Hub uses sibling repositories grouped by a collection.
The main repository links them; it does not contain nested Git repositories
or any model weights. Each download selects one variant and shared components.

| Repository under `devin-lai/` | Contents | Selection |
|---|---|---|
| `MiniMax-H3-Image-mlx` | Inference source, documentation, tests and comparison records | Install once |
| `MiniMax-H3-Image-mlx-packed12` | Fifty losslessly packed main DiT blocks | Recommended exact storage choice |
| `MiniMax-H3-Image-mlx-bf16` | Original complete BF16/FP32 transformer | Unmodified storage control |
| `MiniMax-H3-Image-mlx-q8` | Q8 main blocks and token refiners, group 64 | Smaller weights, image changes |
| `MiniMax-H3-Image-mlx-q4` | Q4 main blocks and token refiners, group 64 | Smallest core, larger image changes |
| `MiniMax-H3-Image-mlx-shared` | VAE, PDD heads, native support, configs and modulation tables | Fetched as needed, reused across variants |
| `MiniMax-H3-Image-mlx-examples` | Generated images and visual comparisons | Optional gallery, with manual access review |

The unchanged encoder is fetched from
[`MiniMaxAI/MiniMax-H3`](https://huggingface.co/MiniMaxAI/MiniMax-H3/tree/0919fb684102ef115126612f3fbb84d1027e7317/text_encoder)
at revision `0919fb684102ef115126612f3fbb84d1027e7317`. Only its `text_encoder/`
directory and license are selected. This is about **62.14 GiB** of weights and
tokenizer files; it is a substantial first download. An existing copy can be
reused with `--text-encoder-path`.

The image source is `MiniMaxAI/MiniMax-H3-Image` at revision
`6534ea1c979a5f8cb00c2bd1025d5ca4ee8d8901`. All uploaded model files receive
SHA-256 manifests; the runtime catalog pins each component repository to a
full commit ID. A `v0.4.1` tag provides a human-readable
release name. Runtime options such as compiled execution, VAE tile batches
and reduced steps do not create additional model repositories.

## Layout after downloading

```text
models/packed12/
  release.json
  transformer/             # Native constants, norms, refiners and config
  core/                    # Only the chosen variant
  modulation/              # Six-step generation and editing tables
  vae/
  pdd_config.json
  pdd_fused_heads.safetensors
  text_encoder/            # Link to the one shared upstream cache
  licenses/
```

Files are linked to Hugging Face's cache rather than copied. Keep that cache
while using the assembled directory. `--local-files-only` supports cached,
offline assembly. `--verify` rehashes all selected image-model files; the
encoder download uses the Hub's pinned, content-addressed download mechanism.
Download size is different from runtime memory. The prepared release's exact
file sizes are recorded in each repository's `files.json` manifest.