Instructions to use steampunque/Ministral-3-8B-Instruct-2512-MP-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 steampunque/Ministral-3-8B-Instruct-2512-MP-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 steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF # Run inference directly in the terminal: llama cli -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF # Run inference directly in the terminal: llama cli -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
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 steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF # Run inference directly in the terminal: ./llama-cli -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
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 steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF # Run inference directly in the terminal: ./build/bin/llama-cli -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Use Docker
docker model run hf.co/steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
- LM Studio
- Jan
- Ollama
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with Ollama:
ollama run hf.co/steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
- Unsloth Studio
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with Unsloth Studio:
Install Unsloth Studio (macOS, Linux, WSL)
curl -fsSL https://unsloth.ai/install.sh | sh # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF to start chatting
Install Unsloth Studio (Windows)
irm https://unsloth.ai/install.ps1 | iex # Run unsloth studio unsloth studio -H 0.0.0.0 -p 8888 # Then open http://localhost:8888 in your browser # Search for steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF to start chatting
- Pi
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-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 steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
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 steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Run Hermes
hermes
- OpenClaw new
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
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 "steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF" \ --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"
- Docker Model Runner
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with Docker Model Runner:
docker model run hf.co/steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
- Lemonade
How to use steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Run and chat with the model
lemonade run user.Ministral-3-8B-Instruct-2512-MP-GGUF-{{QUANT_TAG}}List all available models
lemonade list
- Atomic Chat
Mixed Precision GGUF layer quantization of Ministral-3-8B-Instruct-2512 by mistralai
Original model: https://huggingface.co/mistralai/Ministral-3-8B-Instruct-2512-BF16
The hybrid quant employs different quantization levels on a per layer basis to increased flexibility of trading off performance vs file size. Less parameter bits are used at deep layers and more bits at cortex layers to simultaneously optimize quantized size and model performance. This quant was optimized for similar size to Q4_K_M quant with improved performance while using all K quants to increase processing efficiency on old GPUs or CPUs.
The Q4_K_H layer quant is as follows:
LAYER_TYPES='[
[0 ,"Q4_K_L"],[1 ,"Q4_K_M"],[2 ,"Q4_K_S"],[3 ,"Q4_K_M"],[4 ,"Q4_K_S"],[5 ,"Q4_K_M"],[6 ,"Q4_K_S"],[7 ,"Q4_K_S"],
[8 ,"Q4_K_S"],[9 ,"Q4_K_S"],[10,"Q4_K_S"],[11,"Q4_K_S"],[12,"Q4_K_S"],[13,"Q4_K_L"],[14,"Q4_K_S"],[15,"Q4_K_S"],
[16,"Q4_K_M"],[17,"Q4_K_S"],[18,"Q4_K_M"],[19,"Q4_K_S"],[20,"Q4_K_M"],[21,"Q4_K_S"],[22,"Q4_K_M"],[23,"Q4_K_S"],
[24,"Q4_K_M"],[25,"Q4_K_S"],[26,"Q4_K_M"],[27,"Q4_K_S"],[28,"Q4_K_M"],[29,"Q4_K_L"],[30,"Q5_K_S"],[31,"Q5_K_M"],
[32,"Q5_K_L"],[33,"Q6_K_S"]
]'
FLAGS="--token-embedding-type Q4_K --output-tensor-type Q6_K --layer-types-high"
This quant was optimized for good reasoning performance across a curated set of test prompts.
Comparison:
| Quant | size | PPL | Comment |
|---|---|---|---|
| Q4_K_M | 5.2e9 | 6.6 | - |
| Q4_K_H | 5.3e9 | 6.6 | slightly larger than Q4_K_M |
Usage:
This is a vision capable model. It can be used together with its multimedia projector layers to process images and text inputs and generate text outputs. The mmproj file is made available in this repository. To test vision mode follow the docs in the mtmd readme in the tools directory of the source tree https://github.com/ggml-org/llama.cpp/blob/master/tools/mtmd/README.md .
Performance:
On a 4070 with cuda backend gen rate is about 77tps with ~37k context available (F16 KV) and ~63k available (Q8_0 KV)
The model is trained at 16k context which can be extended to 256k using YARN:
-rope-scaling yarn --yarn-orig-ctx 16384 --rope_scale 16
For other than 256k context set rope_scale to the fraction of configured context size / 16384.0.
NOTE: For improved inference performance, context size may be limited to 16k. Unless large context is needed, this is recommended for best performance.
Benchmarks:
A full set of vision benchmarks for the model is given here: https://huggingface.co/spaces/steampunque/benchlm
Download the file from below:
| Link | Type | Size/e9 B | Notes |
|---|---|---|---|
| Ministral-3-8B-Instruct-2512.Q4_K_H.gguf | Q4_K_H | 5.3e9 B | ~Q4_K_M size with better performance |
| Ministral-3-8B-Instruct-2512.mmproj.gguf | F16 | 0.86e9 B | multimedia projector |
A discussion thread about the hybrid layer quant approach can be found here on the llama.cpp git repository:
- Downloads last month
- 27
Model tree for steampunque/Ministral-3-8B-Instruct-2512-MP-GGUF
Base model
mistralai/Ministral-3-8B-Base-2512