File size: 3,897 Bytes
1114583 83a5f2d 1114583 83a5f2d 1114583 83a5f2d 1114583 | 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 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 | ---
library_name: mlx-audio
pipeline_tag: text-to-audio
base_model: MiniMaxAI/MiniMax-Music3
license: other
license_name: minimax-music3-community-license
license_link: https://huggingface.co/MiniMaxAI/MiniMax-Music3/blob/main/LICENSE
inference: false
tags:
- mlx
- mlx-audio
- apple-silicon
- music-generation
- text-to-music
- text-to-audio
- bf16
---
# MiniMax Music 3 路 MLX BF16
Native MLX BF16 weights for
[`MiniMaxAI/MiniMax-Music3`](https://huggingface.co/MiniMaxAI/MiniMax-Music3),
converted for lyric-conditioned song generation on Apple Silicon with
[`mlx-audio`](https://github.com/Blaizzy/mlx-audio).
> Community conversion, not an official MiniMax release. All model credit goes
> to MiniMax. Review the original model card and license before use.
Other MLX variants:
[`8-bit`](https://huggingface.co/mlx-community/MiniMax-Music3-8bit)
路 [`6-bit`](https://huggingface.co/mlx-community/MiniMax-Music3-6bit)
路 [`4-bit`](https://huggingface.co/mlx-community/MiniMax-Music3-4bit)
路 [`MXFP8 (recommended quantized)`](https://huggingface.co/mlx-community/MiniMax-Music3-mxfp8)
路 [`MXFP4 (experimental)`](https://huggingface.co/mlx-community/MiniMax-Music3-mxfp4)
路 [`NVFP4 (experimental)`](https://huggingface.co/mlx-community/MiniMax-Music3-nvfp4)
## Install
MiniMax Music 3 support was merged upstream in
[`Blaizzy/mlx-audio#888`](https://github.com/Blaizzy/mlx-audio/pull/888).
Until a PyPI release includes it, install the upstream merge commit directly:
```bash
python -m pip install "mlx-audio @ git+https://github.com/Blaizzy/mlx-audio.git@784b29e2691a93ca7483147d86f61859dfaa6296"
```
## Generate
```bash
python -m mlx_audio.music.generate \
--model mlx-community/MiniMax-Music3-bf16 \
--caption "Warm acoustic pop, 96 BPM, intimate female vocal" \
--lyrics $'[verse]\nMorning light across the room\n[chorus]\nSing with me' \
--duration 30 \
--steps 30 \
--seed 7 \
--output song.wav
```
```python
from mlx_audio.music import load
model = load("mlx-community/MiniMax-Music3-bf16")
result = next(
model.generate(
text="Warm acoustic pop, 96 BPM, intimate female vocal",
lyrics="[verse]\nMorning light across the room\n[chorus]\nSing with me",
duration=30,
steps=30,
seed=7,
)
)
print(result.audio.shape, result.sample_rate) # stereo, 44100 Hz
```
Lyrics are required by the checkpoint contract. Use `[instrumental]` explicitly
for instrumental generation. Duration is a requested upper bound: the
autoregressive stage may emit its end token early. Style, tempo, instrument, and
vocal controls are probabilistic rather than strict.
## Conversion and verification
- Dense BF16; no weight quantization.
- Complete native pipeline: Qwen3 global autoregressive model, RVQ depth
decoder, condition encoder, flow-matching DiT/Euler stage, and stereo vocoder.
- The actual component configs produce 44.1 kHz stereo output.
- Official-checkpoint conversion maps and strict-loads all 982 expected tensors.
- Full-checkpoint float32 maximum absolute differences against the official
PyTorch implementations: Qwen logits `1.45e-4`, RVQ depth `2.50e-5`, condition
encoder `1.91e-6`, flow transformer `7.63e-6`, vocoder `8.57e-7`.
- The mlx-audio regression suite passed 1,742 tests with 34 expected skips; the
focused music, converter, and registry suite passed 43 tests and 3 subtests.
- Real generation produced finite 44.1 kHz stereo audio. A 210-second request
exercised 38 denoising windows and ended at 152.8 seconds when the model
emitted EOS.
Converted with `mlx-audio` 0.4.8 development commit `c2fa486` and MLX 0.31.2.
## License
The weights remain subject to the
[`MiniMax-Music3 Community License`](https://huggingface.co/MiniMaxAI/MiniMax-Music3/blob/main/LICENSE),
including its acceptable-use and commercial terms. The full license text is
included in this repository.
|