Upload MiniMax Music 3 affine 8-bit MLX weights

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+tokenizer/tokenizer.json filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,127 @@
+MiniMax-Music3 COMMUNITY LICENSE
+
+Copyright (c) 2026 MiniMax
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this Software,
+including the model weights, parameters, configuration files, inference code and associated
+documentation (the “Software”), to deal in the Software, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or provide copies of the Software,
+and to permit persons to whom the Software is furnished to do so, subject to the following
+conditions:
+
+1. The above copyright notice and this permission notice shall be included in all copies or
+substantial portions of the Software.
+
+2. Your use of the Software must comply with applicable laws and regulations (including
+trade-compliance laws and regulations) and must comply with the Acceptable Use Policy in Exhibit A.
+Especially, you must not violate any third party’s intellectual-property or other rights while using
+the Software.
+
+3. Commercial Terms
+
+    1. You shall prominently display “MiniMax-Music3” on the user interface of commercial product or
+    service that uses the Software.
+
+    2. You shall obtain a separate, prior written authorization from MiniMax by contacting
+    api@minimax.io with the subject line “MiniMax-Music3 licensing - authorization request”, if the
+    aggregate yearly revenue generated from such products and services provided by you and/or any of
+    your affiliates exceeds 20 million US dollars (or equivalent in other currencies).
+
+4. If you provide or make available to any third party a product, service, or hosted service that
+permits the generation of outputs using the Software, you must, before making that product or
+service available and throughout its operation, implement, maintain, test, and periodically review
+reasonable and proportionate technical and organizational safeguards designed to prevent and
+mitigate access, uses, and outputs that violate this License, including uses or outputs that
+infringe, misappropriate, or otherwise violate any third party’s intellectual-property or other
+rights. You must not knowingly disable, materially weaken, or permit the circumvention of those
+safeguards. You are responsible for implementing and enforcing these requirements with respect to
+your products, services, systems, users, and downstream recipients.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT
+NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES
+OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. YOU SHALL BE SOLELY
+RESPONSIBLE FOR DETERMINING THE APPROPRIATENESS OF USING, REPRODUCING, MODIFYING, PERFORMING,
+DISPLAYING OR DISTRIBUTING ANY OF THE SOFTWARE OR OUTPUTS AND ASSUME ANY AND ALL RISKS ASSOCIATED
+WITH YOUR OR A THIRD PARTY’S USE OR DISTRIBUTION OF ANY OF THE SOFTWARE OR OUTPUTS AND YOUR EXERCISE
+OF RIGHTS AND PERMISSIONS UNDER THIS LICENSE. YOU SHALL INDEMNIFY AND HOLD HARMLESS MINIMAX FROM AND
+AGAINST ANY AND ALL LOSSES, LIABILITIES, DAMAGES, CLAIMS, COSTS, AND EXPENSES ARISING OUT OF OR
+RELATING TO ANY OF YOUR BREACH OF THIS LICENSE.
+
+Please note that MiniMax-Music3 was fine-tuned from Qwen3-8B (https://huggingface.co/Qwen/Qwen3-8B),
+which is licensed under the Apache License 2.0
+(https://huggingface.co/Qwen/Qwen3-8B/blob/main/LICENSE). DiT-2B was modified from the  Stable Audio
+code (https://github.com/Stability-AI/stable-audio-tools), which is licensed under the MIT License
+(https://github.com/Stability-AI/stable-audio-tools/blob/main/LICENSE). The VAE was modified from
+the DAC code (https://github.com/descriptinc/descript-audio-codec), which is licensed under the MIT
+License (https://github.com/descriptinc/descript-audio-codec/blob/main/LICENSE).
+
+Exhibit A — Acceptable Use Policy
+
+MiniMax reserves the right to update this Acceptable Use Policy from time to time.
+
+Last revised: August [6], 2026.
+
+MiniMax is committed to promoting the safe and responsible use of its tools and features. You agree
+not to use the Software and in any of the following ways:
+
+1. Use in any manner that violates any applicable national, federal, state, local, or international
+law, regulation, or other legal requirement, or that infringes, misappropriates, or otherwise
+violates any third party’s intellectual-property or other proprietary rights, including without
+limitation, through unauthorized reproduction, distribution, public display, public performance, or
+creation of derivative works;
+
+2. Use in any manner that may harm yourself or others;
+
+3. Use to generate, repurpose or distribute any content to harm yourself or others;
+
+4. Use to circumvent or bypass any safety guardrails or safeguards we have implemented;
+
+5. Use in any manner that exploits or harms, or intends to exploit or harm, minors;
+
+6. Use to generate or disseminate verifiably false information and/or content for the purpose of
+harming others or influencing elections;
+
+7. Use to manufacture or facilitate false online engagement, including fake reviews and other means
+of false online engagement;
+
+8. Use to intentionally defame, disparage, or otherwise harass others;
+
+9. Use to generate and/or disseminate malware (including ransomware) or any other content intended
+to damage electronic systems;
+
+10. Use to generate or disseminate personally identifiable information for the purpose of harming
+others;
+
+11. Use to generate or disseminate information (including images, code, posts, or articles) in or to
+any public environment (including via bot tweets or similar means) without clearly and prominently
+disclosing that such information and/or content is machine-generated;
+
+12. Use to impersonate another person without that person’s consent, authorization, or lawful right
+to do so;
+
+13. Use to make high-risk automated decisions in critical domains that affect individual safety,
+rights, or well-being (such as law enforcement, immigration, healthcare or medical services,
+critical-infrastructure management, product-safety components, essential services, credit,
+employment, housing, education, social scoring, or insurance);
+
+14. Use in any manner that violates or disregards the social, ethical, or moral standards of other
+countries or regions;
+
+15. Use to carry out, assist, threaten, incite, plan, advocate for, or encourage violent extremism
+or terrorism;
+
+16. Use for any purpose intended to discriminate against, or harm, individuals or groups based on
+protected characteristics or categories, online or offline social behavior, or known or predicted
+personality traits;
+
+17. Use to intentionally exploit the vulnerabilities of specific populations based on age, social,
+physical, or psychological characteristics, so as to materially distort the behavior of a member of
+that group in a manner that causes, or is likely to cause, physical or psychological harm to that
+person or to others;
+
+18. Use for military purposes; and
+
+19. Use to engage in any unauthorized or unlicensed professional activity, including but not limited
+to financial, legal, medical or healthcare, or other professional practice.

README.md

@@ -0,0 +1,100 @@
+---
+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
+  - quantized
+  - 8bit
+---
+
+# MiniMax Music 3 · MLX 8-bit
+
+Native MLX affine 8-bit 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:
+[`BF16`](https://huggingface.co/mlx-community/MiniMax-Music3-bf16)
+· [`6-bit`](https://huggingface.co/mlx-community/MiniMax-Music3-6bit)
+· [`4-bit`](https://huggingface.co/mlx-community/MiniMax-Music3-4bit)
+· [`MXFP8`](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 is proposed in
+[`Blaizzy/mlx-audio#888`](https://github.com/Blaizzy/mlx-audio/pull/888).
+Until that PR is released, install the tested commit directly:
+
+```bash
+python -m pip install "mlx-audio @ git+https://github.com/pinglin/mlx-audio.git@c2fa486ddf98ea8268c227b6d624b2f9ba00dbab"
+```
+
+## Generate
+
+```bash
+python -m mlx_audio.music.generate \
+  --model mlx-community/MiniMax-Music3-8bit \
+  --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-8bit")
+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.
+
+## Quantization and verification
+
+- Affine 8-bit weight quantization with group size 64.
+- Large linears in the global language model, RVQ depth decoder, and flow
+  transformer are quantized. Embeddings, output heads, convolutions, condition
+  encoder, and vocoder remain dense for fidelity.
+- The three weight shards total 14,167,688,378 bytes.
+- Strict loading and real generation produced finite 44.1 kHz stereo audio.
+- The mlx-audio regression suite passed 1,738 tests with 34 expected skips; the
+  focused music, converter, and registry suite passed 43 tests and 3 subtests.
+
+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.

config.json

@@ -0,0 +1,63 @@
+{
+    "architectures": [
+        "MiniMaxMusic3ForConditionalGeneration"
+    ],
+    "audio_cfg_token_id": 151654,
+    "audio_code_offset": 151675,
+    "audio_end_token_id": 151670,
+    "audio_vocab_size": 1024,
+    "condition_out_dim": 2048,
+    "depth_intermediate_size": 6144,
+    "depth_max_position_embeddings": 16,
+    "depth_num_heads": 16,
+    "depth_num_layers": 4,
+    "dit_ff_inner_dim": 8192,
+    "dit_fourier_dim": 256,
+    "dit_head_dim": 64,
+    "dit_in_channels": 128,
+    "dit_num_heads": 32,
+    "dit_num_layers": 36,
+    "dit_rotary_dim": 32,
+    "extra": {},
+    "frame_rate": 25.0,
+    "head_dim": 128,
+    "hidden_size": 4096,
+    "input_hop_length": 960,
+    "input_sampling_rate": 24000,
+    "intermediate_size": 12288,
+    "max_position_embeddings": 10240,
+    "model_path": "",
+    "model_type": "minimax_music3",
+    "num_attention_heads": 32,
+    "num_codebooks": 8,
+    "num_condition_layers": 8,
+    "num_hidden_layers": 36,
+    "num_key_value_heads": 8,
+    "output_hop_length": 512,
+    "output_sampling_rate": 44100,
+    "quantization": {
+        "group_size": 64,
+        "bits": 8,
+        "mode": "affine"
+    },
+    "quantization_config": {
+        "group_size": 64,
+        "bits": 8,
+        "mode": "affine"
+    },
+    "rms_norm_eps": 1e-06,
+    "rope_theta": 1000000.0,
+    "sample_rate": 44100,
+    "semantic_vocab_size": 16384,
+    "tie_word_embeddings": false,
+    "torch_dtype": "bfloat16",
+    "vocab_size": 200000,
+    "vocoder_hidden_dim": 1536,
+    "vocoder_input_dim": 1024,
+    "vocoder_upsampling_ratios": [
+        8,
+        8,
+        4,
+        2
+    ]
+}

model-00001-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3706f9e3187a6647f0dab1e5d572ab9047f2c85c3fe2b35373ed61fcb8886151
+size 5355441085

model-00002-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:07745386b66f72195adc7f182fc7a887d2a6d07df55aa52580d7646a6bf0a5f6
+size 5360690514

model-00003-of-00003.safetensors

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e91006a1a86f63558d95c2597c298b6ce3cb7c2a5e15ecf1d4e43db9ac055558
+size 3451556779

scheduler/scheduler_config.json

@@ -0,0 +1,18 @@
+{
+  "_class_name": "FlowMatchEulerDiscreteScheduler",
+  "_diffusers_version": "0.40.0.dev0",
+  "base_image_seq_len": 256,
+  "base_shift": 0.5,
+  "invert_sigmas": true,
+  "max_image_seq_len": 4096,
+  "max_shift": 1.15,
+  "num_train_timesteps": 1,
+  "shift": 1.0,
+  "shift_terminal": null,
+  "stochastic_sampling": false,
+  "time_shift_type": "exponential",
+  "use_beta_sigmas": false,
+  "use_dynamic_shifting": false,
+  "use_exponential_sigmas": false,
+  "use_karras_sigmas": false
+}

tokenizer/chat_template.jinja

@@ -0,0 +1,89 @@
+{%- if tools %}
+    {{- '<|im_start|>system\n' }}
+    {%- if messages[0].role == 'system' %}
+        {{- messages[0].content + '\n\n' }}
+    {%- endif %}
+    {{- "# Tools\n\nYou may call one or more functions to assist with the user query.\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>" }}
+    {%- for tool in tools %}
+        {{- "\n" }}
+        {{- tool | tojson }}
+    {%- endfor %}
+    {{- "\n</tools>\n\nFor each function call, return a json object with function name and arguments within <tool_call></tool_call> XML tags:\n<tool_call>\n{\"name\": <function-name>, \"arguments\": <args-json-object>}\n</tool_call><|im_end|>\n" }}
+{%- else %}
+    {%- if messages[0].role == 'system' %}
+        {{- '<|im_start|>system\n' + messages[0].content + '<|im_end|>\n' }}
+    {%- endif %}
+{%- endif %}
+{%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %}
+{%- for message in messages[::-1] %}
+    {%- set index = (messages|length - 1) - loop.index0 %}
+    {%- if ns.multi_step_tool and message.role == "user" and message.content is string and not(message.content.startswith('<tool_response>') and message.content.endswith('</tool_response>')) %}
+        {%- set ns.multi_step_tool = false %}
+        {%- set ns.last_query_index = index %}
+    {%- endif %}
+{%- endfor %}
+{%- for message in messages %}
+    {%- if message.content is string %}
+        {%- set content = message.content %}
+    {%- else %}
+        {%- set content = '' %}
+    {%- endif %}
+    {%- if (message.role == "user") or (message.role == "system" and not loop.first) %}
+        {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }}
+    {%- elif message.role == "assistant" %}
+        {%- set reasoning_content = '' %}
+        {%- if message.reasoning_content is string %}
+            {%- set reasoning_content = message.reasoning_content %}
+        {%- else %}
+            {%- if '</think>' in content %}
+                {%- set reasoning_content = content.split('</think>')[0].rstrip('\n').split('<think>')[-1].lstrip('\n') %}
+                {%- set content = content.split('</think>')[-1].lstrip('\n') %}
+            {%- endif %}
+        {%- endif %}
+        {%- if loop.index0 > ns.last_query_index %}
+            {%- if loop.last or (not loop.last and reasoning_content) %}
+                {{- '<|im_start|>' + message.role + '\n<think>\n' + reasoning_content.strip('\n') + '\n</think>\n\n' + content.lstrip('\n') }}
+            {%- else %}
+                {{- '<|im_start|>' + message.role + '\n' + content }}
+            {%- endif %}
+        {%- else %}
+            {{- '<|im_start|>' + message.role + '\n' + content }}
+        {%- endif %}
+        {%- if message.tool_calls %}
+            {%- for tool_call in message.tool_calls %}
+                {%- if (loop.first and content) or (not loop.first) %}
+                    {{- '\n' }}
+                {%- endif %}
+                {%- if tool_call.function %}
+                    {%- set tool_call = tool_call.function %}
+                {%- endif %}
+                {{- '<tool_call>\n{"name": "' }}
+                {{- tool_call.name }}
+                {{- '", "arguments": ' }}
+                {%- if tool_call.arguments is string %}
+                    {{- tool_call.arguments }}
+                {%- else %}
+                    {{- tool_call.arguments | tojson }}
+                {%- endif %}
+                {{- '}\n</tool_call>' }}
+            {%- endfor %}
+        {%- endif %}
+        {{- '<|im_end|>\n' }}
+    {%- elif message.role == "tool" %}
+        {%- if loop.first or (messages[loop.index0 - 1].role != "tool") %}
+            {{- '<|im_start|>user' }}
+        {%- endif %}
+        {{- '\n<tool_response>\n' }}
+        {{- content }}
+        {{- '\n</tool_response>' }}
+        {%- if loop.last or (messages[loop.index0 + 1].role != "tool") %}
+            {{- '<|im_end|>\n' }}
+        {%- endif %}
+    {%- endif %}
+{%- endfor %}
+{%- if add_generation_prompt %}
+    {{- '<|im_start|>assistant\n' }}
+    {%- if enable_thinking is defined and enable_thinking is false %}
+        {{- '<think>\n\n</think>\n\n' }}
+    {%- endif %}
+{%- endif %}

tokenizer/tokenizer.json

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:b1537fa9e59a537276ecbc2e12d0438edff635a1f4a4948e679774b5feb3e610
+size 11423801

tokenizer/tokenizer_config.json

@@ -0,0 +1,15 @@
+{
+  "add_prefix_space": false,
+  "backend": "tokenizers",
+  "bos_token": null,
+  "clean_up_tokenization_spaces": false,
+  "eos_token": "<|im_end|>",
+  "errors": "replace",
+  "is_local": true,
+  "local_files_only": false,
+  "model_max_length": 131072,
+  "pad_token": "<|endoftext|>",
+  "split_special_tokens": false,
+  "tokenizer_class": "Qwen2Tokenizer",
+  "unk_token": null
+}