CoolFace
Modelpublic

Abiray/MiniMax-Music3-GGUF

sourceHugging Faceapache-2.0updated 1mo agoView on Hugging Face
35likes3.2kdownloads
Model Card

MiniMax-Music-3 GGUF Quantizations

This repository contains GGUF quantizations for the diffusion transformer / DiT backbone of MiniMax-Music3, a state-of-the-art text-to-music model capable of generating structured, full-length songs up to 5 minutes long at 32 kHz stereo.

These quantized weights enable running MiniMax-Music-3 locally inside ComfyUI using the ComfyUI-GGUF custom node with significantly lower VRAM requirements.

📦 Quantized Files & Recommendations

File NameQuantizationSizeRecommended Use
MiniMax-Music3-F16.ggufF164.98 GBUncompressed reference baseline
MiniMax-Music3-Q8_0.ggufQ8_02.70 GBNear-lossless audio fidelity (Recommended)
MiniMax-Music3-Q6_K.ggufQ6_K2.12 GBExcellent fidelity, minimal compression loss
MiniMax-Music3-Q5_K_M.ggufQ5KM1.79 GBGreat balance of speed and VRAM footprint
MiniMax-Music3-Q4_K_M.ggufQ4KM1.49 GBLow VRAM setups (8GB–10GB GPUs)
MiniMax-Music3-Q3_K_M.ggufQ3KM1.16 GBUltra-low VRAM (May introduce audible softening)

🧩 Required Companion Files

The GGUF files in this repository replace only the diffusion transformer (DiT). To generate music in ComfyUI, you will also need the text encoder and VAE models provided by Comfy-Org:

📂 ComfyUI File Placement

Place the downloaded files into their respective folders in your ComfyUI installation:

text
ComfyUI/
└── models/
    ├── diffusion_models/   (or models/unet/)
    │   └── MiniMax-Music3-Q8_0.gguf
    │
    ├── text_encoders/       (or models/clip/)
    │   └── minimax_music3_text_encoder_bf16.safetensors
    │
    └── vae/
        └── minimax_music3_dav.safetensors

🚀 How to Use in ComfyUI

  1. 1.Install the ComfyUI-GGUF extension via ComfyUI Manager.
  2. 2.In your workflow:
  3. 3.Load the GGUF model using `Unet Loader (GGUF)`.
  4. 4.Load the text encoder using the standard CLIP / Text Encoder loader.
  5. 5.Load the VAE using the standard VAE loader.

📥 CLI Download Commands

1. Download GGUF Model

bash
huggingface-cli download Abiray/MiniMax-Music3-GGUF MiniMax-Music3-Q8_0.gguf --local-dir ComfyUI/models/diffusion_models

2. Download Companion Text Encoder & VAE

bash
# Text Encoder
huggingface-cli download Comfy-Org/MiniMax-Music-3 text_encoders/minimax_music3_text_encoder_bf16.safetensors --local-dir ComfyUI/models/text_encoders --local-dir-use-symlinks False

# VAE
huggingface-cli download Comfy-Org/MiniMax-Music-3 vae/minimax_music3_dav.safetensors --local-dir ComfyUI/models/vae --local-dir-use-symlinks False

✍️ Prompting Structure

MiniMax-Music-3 generates the best results when given two separate conditioning inputs:

Lyrics (with section markers on individual lines)

text
[Verse]
Morning light filtering through the pine
Every quiet street is yours and mine

[Chorus]
Softly the world begins to breathe

Music Description

text
Genre: acoustic pop. BPM: 96. Key: C major. Warm and intimate, building gently into the chorus.
Vocals: soft female lead, close and breathy, light stacked harmonies in the chorus.
Arrangement: fingerpicked guitar and soft piano; brushed drums and upright bass enter in the chorus.

📜 Credits & License