Instructions to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS # Run inference directly in the terminal: llama cli -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS # Run inference directly in the terminal: llama cli -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS # Run inference directly in the terminal: ./llama-cli -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS # Run inference directly in the terminal: ./build/bin/llama-cli -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
Use Docker
docker model run hf.co/fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
- LM Studio
- Jan
- vLLM
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-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": "fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
- Ollama
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with Ollama:
ollama run hf.co/fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
- Unsloth Desktop
- Pi
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
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": "fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with Docker Model Runner:
docker model run hf.co/fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
- Lemonade
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
Run and chat with the model
lemonade run user.KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF-IQ3_XXS
List all available models
lemonade list
- Hermes Agent
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
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 fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS
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 "fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF:IQ3_XXS" \ --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"
KAT-Coder-V2.5-Dev — Mixed Quantization
A mixed-quantization build of KAT-Coder-V2.5-Dev, aiming to balance model size and inference performance. The IQ4_XS quantization rounds out at about 19GB, and can comfortably fit on 22-24GB cards. On my 16GB vram 7800XT this works out to about 20+ tokens/s with 32k context. The IQ3_XXS was created to fit within a 16GB card, and I've managed to hit 46t/s.
Quantization Details
The model uses a mixture of IQ3_XXS, IQ4_XS, Q6_K and Q8_0, with selected tensors kept at higher precision to help preserve model quality. A self-calibrated imatrix was used.
| Component | IQ4_XS | IQ3_XXS |
|---|---|---|
| size | 19.5GB | 15GB |
| ffn_gate_exps, ffn_up_exps (all 40 layers) | IQ4_XS | IQ3_XXS |
| ffn_down_exps, layers 0-3 and 36-39 | IQ4_XS | IQ4_XS |
| ffn_down_exps, the other 32 layers | IQ4_XS | IQ3_XXS |
| Embeddings | Q8_0 | Q8_0 |
| Output | Q8_0 | Q8_0 |
| Attention | Q6_K | Q6_K |
| ssm_out | Q6_K | Q6_K |
| Shared expert | Q6_K | Q6_K |
For more information check out the gguf dumps:
Benchmarks (WIP)
- Sometimes the model will understand the problem but the code that comes out isn't the same. So I tried using a system prompt to see if it will rectify it (and it does to an extent). The system prompt used was "After writing the code, trace the first example through it and confirm the output matches."
- Methodology: Every problem in each test set are given three runs each to look for issues/variance in how the model solves them (e.g. HumanEval with 164 problems * 3 = 492)
- All models are tested at 0.7 Temp and 0.9 top-p.
Human Eval
| Model | Pass Rate | Mean Tokens | Doubt/Problem | Doubt median/p90/max | Spirals | Pass: calm / doubting | Doubt-free | Hit limit | Tok/s |
|---|---|---|---|---|---|---|---|---|---|
| IQ4_XS (system prompt) | 96% | 489 | 0.46 | 0 / 1 / 12 | 1% | 96% / 93% | 82% | 1% | 25.9 |
| IQ4_XS (base) | 92% | 286 | 0.33 | 0 / 0 / 22 | 1% | 95% / 73% | 90% | 0% | 26.5 |
| IQ3_XXS (system prompt) | 93% | 522 | 0.59 | 0 / 1 / 32 | 1% | 96% / 82% | 82% | 1% | 37.0 |
| IQ3_XXS (base) | 92% | 348 | 0.60 | 0 / 1 / 39 | 1% | 96% / 78% | 79% | 1% | 74.0 |
mbppplus
| Model | Pass Rate | Mean Tokens | Doubt/Problem | Doubt median/p90/max | Spirals | Pass: calm / doubting | Doubt-free | Hit limit | Tok/s |
|---|---|---|---|---|---|---|---|---|---|
| IQ4_XS (system prompt) | 79% | 306 | 0.74 | 0 / 1 / 44 | 2% | 81% / 68% | 81% | 1% | 24.4 |
| IQ4_XS (base) | 78% | 201 | 0.68 | 0 / 1 / 59 | 2% | 81% / 65% | 83% | 1% | 26.4 |
| IQ3_XXS (system prompt) | 79% | 316 | 1.00 | 0 / 2 / 47 | 3% | 83% / 64% | 80% | 2% | 45.2 |
| IQ3_XXS (base) | 77% | 226 | 0.73 | 0 / 1 / 38 | 2% | 81% / 61% | 81% | 1% | 44.5 |
Rationale
After extensive testing, this configuration appeared to offer a good balance between file size and model performance. Higher precision is retained for selected components, while the majority of the model uses less bits for a more compact footprint. Logically the IQ_4XS should be better but if you have a 16GB card this can cut your token generation speed in half. The IQ3_XXS seemed to do as well as far as I can tell, but in benchmarks it failed more times due to doubt spirals.
Notes
- These are a quantized derivatives of the original model, not a new base model.
- Quantization settings reflect my own testing and trade-offs.
- The imatrix was focused mostly on webdev, python and markdown documentation.
- Testing is still underway and I'm trying to get a tangible benchmark.
- For the original model's capabilities, intended use, and licensing, refer to the original model repository.
- Downloads last month
- 2,274
3-bit
4-bit
Model tree for fooooooooooooooooooooooooooooooooooooooooo/KAT-Coder-V2.5-Dev-16GB-MixedQuant-GGUF
Base model
Kwaipilot/KAT-Coder-V2.5-Dev