Instructions to use Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf # Run inference directly in the terminal: llama cli -hf Ninnix96/KAT-Coder-V2.5-Dev-gguf
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf Ninnix96/KAT-Coder-V2.5-Dev-gguf # Run inference directly in the terminal: llama cli -hf Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf # Run inference directly in the terminal: ./llama-cli -hf Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf # Run inference directly in the terminal: ./build/bin/llama-cli -hf Ninnix96/KAT-Coder-V2.5-Dev-gguf
Use Docker
docker model run hf.co/Ninnix96/KAT-Coder-V2.5-Dev-gguf
- LM Studio
- Jan
- vLLM
How to use Ninnix96/KAT-Coder-V2.5-Dev-gguf with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "Ninnix96/KAT-Coder-V2.5-Dev-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": "Ninnix96/KAT-Coder-V2.5-Dev-gguf", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/Ninnix96/KAT-Coder-V2.5-Dev-gguf
- Ollama
How to use Ninnix96/KAT-Coder-V2.5-Dev-gguf with Ollama:
ollama run hf.co/Ninnix96/KAT-Coder-V2.5-Dev-gguf
- Unsloth Studio
How to use Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for Ninnix96/KAT-Coder-V2.5-Dev-gguf to start chatting
- Pi
How to use Ninnix96/KAT-Coder-V2.5-Dev-gguf with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Ninnix96/KAT-Coder-V2.5-Dev-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": "Ninnix96/KAT-Coder-V2.5-Dev-gguf" } ] } } }Run Pi
# Start Pi in your project directory: pi
- OpenClaw new
How to use Ninnix96/KAT-Coder-V2.5-Dev-gguf with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf Ninnix96/KAT-Coder-V2.5-Dev-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 "Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf with Docker Model Runner:
docker model run hf.co/Ninnix96/KAT-Coder-V2.5-Dev-gguf
- Lemonade
How to use Ninnix96/KAT-Coder-V2.5-Dev-gguf with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull Ninnix96/KAT-Coder-V2.5-Dev-gguf
Run and chat with the model
lemonade run user.KAT-Coder-V2.5-Dev-gguf-{{QUANT_TAG}}List all available models
lemonade list
- Hermes Agent
How to use Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-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 Ninnix96/KAT-Coder-V2.5-Dev-gguf
Run Hermes
hermes
- Atomic Chat
Error loading the GGUF using instructions from README
Hi, there. Just a quick heads up:
$ llama-server -hf Ninnix96/KAT-Coder-V2.5-Dev-gguf
0.00.394.961 E common_download_get_hf_plan: no GGUF files found in repository Ninnix96/KAT-Coder-V2.5-Dev-gguf
0.00.394.963 I Available GGUF files:
0.00.394.963 I - KAT-Coder-V2.5-Dev-IQ2XXS-w2Q2K-AProjQ8-SExpQ8-OutQ8-imatrix.gguf
0.00.394.980 I cmn common_param: common_params_print_info: verbosity = 3 (adjust with the `-lv N` CLI arg)
0.00.482.422 W srv llama_server: -----------------
0.00.482.424 W srv llama_server: CORS is set to allow all origins ('*') and no API key is set
0.00.482.424 W srv llama_server: this can be a security risk (cross-origin attacks)
0.00.482.424 W srv llama_server: more info: https://github.com/ggml-org/llama.cpp/pull/25655
0.00.482.425 W srv llama_server: -----------------
0.00.482.472 E srv start: couldn't bind HTTP server socket, hostname: 127.0.0.1, port: 8080
0.00.482.472 I srv operator(): operator(): cleaning up before exit...
0.00.482.572 E srv llama_server: exiting due to HTTP server error
the same error happens if I try to add the model to my llama-server "models.ini" (router mode) using the model tag [Ninnix96/KAT-Coder-V2.5-Dev-gguf:IMATRIX]. For some reason HF does not recognize the GGUF, as it is not listed in the model's card as well:
Besides that, some quick results from quick nondeterministic tests:
- Good performance when compared with APEX I-Compact for basic math/logic prompts
- It may enter a CoT loop inside the "thinking" tags, probably
presence-penalty=1.5as suggested in the original model card will help - I thought this would be much faster than base APEX-I-Compact or IQ4_XS, but it was the same speed or maybe a bit slower,
my bet is that some layers are in still in F32 (I use an Ampere card, and I see an improvement in tg speed when using Q8 or at least BF16)(nvm, I checked the other weights that have higher tg and they also use F32 in some layers, so the difference is something else) - For some reason, this is the only KAT-Coder-v2.5-Dev variant so far that still "tries to find" an answer for difficult tests, like base Qwen3.6, all the others seem super over-confident and stick to the first option that is generated and go ahead giving it as (wrong) answer
Have you tried a maybe not so extreme scheme for quantization, maybe Q3_K/IQ3_XSS? Is there a big difference in size? My bet is that reducing the remaining F32 layers to Q8_0 will improve tg speed while keeping the quality, just a thought...
Thank you for providing the weights and detailed info in the model card. Regards
Hi,
Found the culprit: the filename itself contains imatrix. llama.cpp deliberately treats any *.gguf whose filename contains imatrix as an auxiliary importance-matrix file, not as a runnable model.
Specify the exact file with --hf-file; this bypasses automatic model-file detection:
Try with:
llama-server
-hf Ninnix96/KAT-Coder-V2.5-Dev-gguf
-hff KAT-Coder-V2.5-Dev-IQ2XXS-w2Q2K-AProjQ8-SExpQ8-OutQ8-imatrix.gguf
--port 8081
Thanks you, if is so annoying I will rename the file.
As for quantization, I plan to release a larger version with the 4-5 most important layers at Q4. I still have to find the recipe that best fits.
I was able to download and load the file earlier, thanks. It was just a heads up since people following the README will not be able to use the GGUF, and probably ollama will fail as well. As the repo is still kinda fresh, I would recommend removing "imatrix" from the name, maybe use something like "iM"... Regards
Yes, you're right, I updated, thanks again.
