Abiray/MiniMax-Music3-GGUF

🤗 Hugging Face 来源text-to-audioapache-2.014 GBGGUF✓ 6 个校验和今天更新
一条命令提交

在你的模型文件夹旁边运行它。它会制作种子、将文件与 Hugging Face 比对,然后提交。你只需开始做种,并粘贴你账户中的密钥。它只读取你的文件,绝不修改。如果愿意,可以先阅读脚本。

curl -fsSL https://pirateface.co/package.sh | bash -s -- --repo Abiray/MiniMax-Music3-GGUF ./model-folder
需要做种者 →

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 Name Quantization Size Recommended Use
MiniMax-Music3-F16.gguf F16 4.98 GB Uncompressed reference baseline
MiniMax-Music3-Q8_0.gguf Q8_0 2.70 GB Near-lossless audio fidelity (Recommended)
MiniMax-Music3-Q6_K.gguf Q6_K 2.12 GB Excellent fidelity, minimal compression loss
MiniMax-Music3-Q5_K_M.gguf Q5_K_M 1.79 GB Great balance of speed and VRAM footprint
MiniMax-Music3-Q4_K_M.gguf Q4_K_M 1.49 GB Low VRAM setups (8GB–10GB GPUs)
MiniMax-Music3-Q3_K_M.gguf Q3_K_M 1.16 GB Ultra-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:

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. Install the ComfyUI-GGUF extension via ComfyUI Manager.
  2. In your workflow:
    • Load the GGUF model using Unet Loader (GGUF).
    • Load the text encoder using the standard CLIP / Text Encoder loader.
    • Load the VAE using the standard VAE loader.

📥 CLI Download Commands

1. Download GGUF Model

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

2. Download Companion Text Encoder & VAE

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

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

[Chorus]
Softly the world begins to breathe

Music Description

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