Instructions to use vultr/MiniMax-M3-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 vultr/MiniMax-M3-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 vultr/MiniMax-M3-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf vultr/MiniMax-M3-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf vultr/MiniMax-M3-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf vultr/MiniMax-M3-GGUF:Q4_K_M
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 vultr/MiniMax-M3-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf vultr/MiniMax-M3-GGUF:Q4_K_M
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 vultr/MiniMax-M3-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf vultr/MiniMax-M3-GGUF:Q4_K_M
Use Docker
docker model run hf.co/vultr/MiniMax-M3-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use vultr/MiniMax-M3-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "vultr/MiniMax-M3-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": "vultr/MiniMax-M3-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/vultr/MiniMax-M3-GGUF:Q4_K_M
- Ollama
How to use vultr/MiniMax-M3-GGUF with Ollama:
ollama run hf.co/vultr/MiniMax-M3-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use vultr/MiniMax-M3-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf vultr/MiniMax-M3-GGUF:Q4_K_M
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": "vultr/MiniMax-M3-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use vultr/MiniMax-M3-GGUF with Docker Model Runner:
docker model run hf.co/vultr/MiniMax-M3-GGUF:Q4_K_M
- Lemonade
How to use vultr/MiniMax-M3-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull vultr/MiniMax-M3-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.MiniMax-M3-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use vultr/MiniMax-M3-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 vultr/MiniMax-M3-GGUF:Q4_K_M
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 vultr/MiniMax-M3-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use vultr/MiniMax-M3-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf vultr/MiniMax-M3-GGUF:Q4_K_M
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 "vultr/MiniMax-M3-GGUF:Q4_K_M" \ --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"
MiniMax M3, GGUF
MiniMax M3 is a native multimodal Mixture-of-Experts model designed for long-context reasoning, coding, and agentic workflows across text, image, and video. Powered by MiniMax Sparse Attention (MSA), it is delivering highly efficient long-context processing and frontier coding performance.
This repository holds Vultr's GGUF quantizations of it. They are hybrid quantizations: rather than applying one precision to the whole network, each layer's precision is chosen from a measured importance score, so the bits go where they change the output most.
Model Overview
| Attribute | Value |
|---|---|
| Base model | MiniMaxAI/MiniMax-M3 |
| Architecture | minimax-m3, Mixture-of-Experts |
| Parameters | approximately 428B |
| Active parameters | 23B |
| Layers | 60 |
| Hidden size | 6,144 |
| Attention heads | 64 |
| Experts | 128 routed, 4 selected per token, plus a shared expert |
| Context length | up to 1M tokens |
| Vocabulary | 200,064 |
| MTP modules | 7 |
| License | MiniMax Community |
| Attribute | Value |
|---|---|
| Base model | MiniMaxAI/MiniMax-M3 |
| Architecture | minimax-m3, Mixture-of-Experts |
| Parameters | approximately 428B |
| Active parameters | 23B |
| Layers | 60 |
| Hidden size | 6,144 |
| Attention heads | 64 |
| Experts | 128 routed, 4 selected per token, plus a shared expert |
| Context length | up to 1M tokens |
| Vocabulary | 200,064 |
| MTP modules | 7 |
| License | MiniMax Community |
Quantizations
| File | Type | Size | KLD vs bf16 |
|---|---|---|---|
| MiniMax-M3-Q5_K_M-*.gguf (3 parts) | Q5_K_M | 332.87 GB | 0.0406 |
| MiniMax-M3-Q4_K_M-*.gguf (2 parts) | Q4_K_M | 283.57 GB | 0.0589 |
| MiniMax-M3-IQ3_M-*.gguf (2 parts) | IQ3_M | 204.85 GB | 0.2048 |
| MiniMax-M3-IQ3_S-*.gguf (2 parts) | IQ3_S | 202.95 GB | 0.2166 |
| File | Type | Size | KLD vs bf16 |
|---|---|---|---|
| MiniMax-M3-Q5_K_M-*.gguf (3 parts) | Q5_K_M | 332.87 GB | 0.0406 |
| MiniMax-M3-Q4_K_M-*.gguf (2 parts) | Q4_K_M | 283.57 GB | 0.0589 |
| MiniMax-M3-IQ3_M-*.gguf (2 parts) | IQ3_M | 204.85 GB | 0.2048 |
| MiniMax-M3-IQ3_S-*.gguf (2 parts) | IQ3_S | 202.95 GB | 0.2166 |
The vision encoder is in MiniMax-M3-mmproj-f16.gguf (1.73 GB). llama.cpp downloads it automatically with the command under Run, so image input works without extra steps.
KL divergence measures how far a quantized model's next-token probabilities drift from those of the original bf16 model, averaged over every token of the evaluation text. The lower the value, the closer the quantized model is to the original; zero would mean identical output.
Evaluation
Every variant in this repository was evaluated against the original bf16 model for perplexity, KL divergence, top-token agreement, HellaSwag and WinoGrande, under identical conditions. The full results are maintained on the model's page in the Vultr Model Library:
https://docs.vultr.com/models/minimax-m3/minimax-m3?tab=quantized
That page is the reference for these files. The summary above is an excerpt from it.
Run
llama-server -hf vultr/MiniMax-M3-GGUF:Q4_K_M
The model's chat template is embedded in every file, so no extra prompt formatting is needed.
License
These files are derived from MiniMaxAI/MiniMax-M3 and are distributed under the same license, MiniMax Community. The model is the work of MiniMax; Vultr produced the quantizations.
- Downloads last month
- 16
3-bit
4-bit
5-bit
Model tree for vultr/MiniMax-M3-GGUF
Base model
MiniMaxAI/MiniMax-M3