Instructions to use unsloth/MiniMax-M3.1-Flash-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use unsloth/MiniMax-M3.1-Flash-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: llama cli -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: llama cli -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: ./llama-cli -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: ./build/bin/llama-cli -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Use Docker
docker model run hf.co/unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
- Llama new
- LM Studio
- Jan
- vLLM
How to use unsloth/MiniMax-M3.1-Flash-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "unsloth/MiniMax-M3.1-Flash-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "unsloth/MiniMax-M3.1-Flash-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
- Ollama
How to use unsloth/MiniMax-M3.1-Flash-GGUF with Ollama:
ollama run hf.co/unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
- Unsloth Desktop
- Pi
How to use unsloth/MiniMax-M3.1-Flash-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use unsloth/MiniMax-M3.1-Flash-GGUF with Docker Model Runner:
docker model run hf.co/unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
- Lemonade
How to use unsloth/MiniMax-M3.1-Flash-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Run and chat with the model
lemonade run user.MiniMax-M3.1-Flash-GGUF-UD-Q4_K_XL
List all available models
lemonade list
- Hermes Agent
How to use unsloth/MiniMax-M3.1-Flash-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Configure Hermes
# Install Hermes: curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes setup # Point Hermes at the local server: hermes config set model.provider custom hermes config set model.base_url http://127.0.0.1:8080/v1 hermes config set model.default unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use unsloth/MiniMax-M3.1-Flash-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL
Configure OpenClaw
# Install OpenClaw: npm install -g openclaw@latest # Register the local server and set it as the default model: openclaw onboard --non-interactive --mode local \ --auth-choice custom-api-key \ --custom-base-url http://127.0.0.1:8080/v1 \ --custom-model-id "unsloth/MiniMax-M3.1-Flash-GGUF:UD-Q4_K_XL" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Memory needed vs common local setups (UD-Q4_K_XL 249.4 GB)
Thanks for the quants. For anyone checking whether this fits their machine, quick math from the file sizes in this repo (HF API, 23 Oct):
- UD-Q4_K_XL: 249.4 GB of files (7 shards)
- UD-Q8_K_XL: 259.1 GB (only ~4% bigger, since the experts already ship in 4-bit)
That's files only, before KV cache and runtime overhead. Usable memory on common setups (our estimates):
- 24 GB GPU: ~23.4 GB
- 32 GB GPU: ~31.4 GB
- 128 GB unified (Mac / DGX Spark class): ~96 GB
- 256 GB Mac Studio: ~192 GB
So UD-Q4_K_XL doesn't fit fully on any single consumer box; you need about 256 GB+ of GPU memory, or offload most experts to system RAM (with 23B active per token, CPU offload is usable but slow). A 2-bit quant (about 156 GB in the community repos) is the only size that fits under ~192 GB.
We keep per-GPU fit estimates here: https://localllmrig.com/can-i-run?utm_source=huggingface&utm_medium=community&utm_campaign=minimax-m3-1-flash
Happy to correct anything if someone has measured numbers.
This model require too much resources and very slow compared to Deepseek V4 1017, i'll pass, its unusable. Launching it with reasoning off not working at all, its mandatory here, with low reasoning it failed simple music notes test.
I used the Q8_K_XLARGE (only high quality, no compromises) and compared to Deepseek Q8_K_XLARGE by Unsloth also the problem started already in allocation resources, Minimax uses much more GPU memory to even launch, on my RTX 4070 16Gb (13 layers vs 22 layers in Deepseek).
And generation speed almost x2 slower in Minimax vs Deeepseek by tok/sec.
Yes Deepseek use many tricks to speed up like Engrams and etc.
With Deepseek i can merge many llama git versions overnight when -50% energy discount and no mistakes, Kalman filtering plugin helping and high reasoning level not affecting speed all in Q8 (300Gb RAM). I cant imagine such in Minimax, they need to make something to speed up model. Only if MXFP4 GGUF will be made maybe i'll check Minimax again.
Thanks, measured reports like this are exactly what file sizes can't tell you. Useful datapoint: on an RTX 4070 16 GB at Q8_K_XL, MiniMax fit 13 layers on the GPU vs 22 for DeepSeek V4.1 Flash 1017, at roughly half the generation speed.
If you have them handy, could you share the tok/s numbers (prompt and generation), the context size and the llama.cpp build for both runs? With your OK we'd add them as a credited user-reported row next to our estimates.