MiniMax-H3-Image-mlx / MODEL_INDEX.md
devin-lai's picture
v0.4.1: enable Hub download statistics
c138412 verified
|
Raw History Blame Contribute Delete
2.84 kB

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 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

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.