Instructions to use KarLexAI/Kimi-K3.1-Pro-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 KarLexAI/Kimi-K3.1-Pro-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 KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M # Run inference directly in the terminal: llama cli -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M # Run inference directly in the terminal: llama cli -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M # Run inference directly in the terminal: ./build/bin/llama cli -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
Use Docker
docker model run hf.co/KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
- Llama new
- LM Studio
- Jan
- vLLM
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "KarLexAI/Kimi-K3.1-Pro-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": "KarLexAI/Kimi-K3.1-Pro-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
- Ollama
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with Ollama:
ollama run hf.co/KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
- Unsloth Desktop
- Pi
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_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": "KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with Docker Model Runner:
docker model run hf.co/KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
- Lemonade
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
Run and chat with the model
lemonade run user.Kimi-K3.1-Pro-GGUF-IQ1_M
List all available models
lemonade list
- Hermes Agent
How to use KarLexAI/Kimi-K3.1-Pro-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 KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_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 KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use KarLexAI/Kimi-K3.1-Pro-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_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 "KarLexAI/Kimi-K3.1-Pro-GGUF:IQ1_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"
Kimi K3.1 Pro is 1.56 TB even as a lossless GGUF. KLX-IQ1_S is 593 GB, about 1.7 bits per weight, and runs entirely on the GPUs of a single 8รH100 node. It still solves 80% of AIME 2025. Standard GGUF, stock llama.cpp, no fork.
โจ Highlights
- ๐ฅ๏ธ The whole model on one node. KLX-IQ1_S loads entirely into 8ร H100 80 GB with 131K tokens of context: 19 tokens/s generating, with no expert left on the CPU.
- ๐ง It still thinks at 1.7 bits per weight. KLX-IQ1_S scores 80.0% on AIME 2025, 91.0% on MATH-500 and 94.0% on IFEval.
- ๐ Closer to the full model than a standard quant of the same size. Mean KL divergence 14.5% lower at 710 GB and 6.2% lower at 648 GB.
- ๐ Plain GGUF. Only standard llama.cpp tensor types. Runs on upstream llama.cpp as it is.
๐ฆ Pick your file
| Folder | Size | Mean KL vs. full model โ | Pick it for |
|---|---|---|---|
| KLX-IQ1_S | 592.7 GB | 0.106 | fitting on one 8รH100 node |
| KLX-IQ1_M | 647.9 GB | 0.084 | the middle ground |
| KLX-IQ2_XXS | 709.9 GB | 0.072 | the closest to the full model |
You need more memory than the file size, in GPU memory plus system RAM. The two larger files keep part of the experts in system RAM on an 8รH100 node. Scores, speeds and how every number was measured: BENCHMARKS.md.
๐ Run it with two commands
hf download KarLexAI/Kimi-K3.1-Pro-GGUF --include "KLX-IQ1_S/*" --local-dir .
llama-server -m KLX-IQ1_S/Kimi-K3.1-Pro-KLX-IQ1_S-00001-of-00014.gguf -ngl 999 --fit off -c 131072 -np 4 --jinja --temp 1.0 --top-p 0.95
Then open http://localhost:8080 and chat. You need llama.cpp with Kimi K3.1 support
(#31779, merged 6 Nov 2026). With less GPU memory, or for the larger
files, use --fit on in place of -ngl 999 --fit off, and llama.cpp decides what stays in system RAM.
๐งพ The fine print
- Post-training quantization of moonshotai/Kimi-K3.1-Pro. No fine-tuning. Text only: the vision encoder is not included.
- Use is governed by the Kimi K3.1-Pro License: see LICENSE.
Made by KarLex AI. If these files save you memory, a โค๏ธ on this repo helps others find them.
Not affiliated with Moonshot AI.
- Downloads last month
- 603
1-bit
2-bit
Model tree for KarLexAI/Kimi-K3.1-Pro-GGUF
Base model
moonshotai/Kimi-K3.1-Pro