Instructions to use anikifoss/Kimi-K2-Instruct-DQ4_K 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 anikifoss/Kimi-K2-Instruct-DQ4_K 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 anikifoss/Kimi-K2-Instruct-DQ4_K # Run inference directly in the terminal: llama cli -hf anikifoss/Kimi-K2-Instruct-DQ4_K
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf anikifoss/Kimi-K2-Instruct-DQ4_K # Run inference directly in the terminal: llama cli -hf anikifoss/Kimi-K2-Instruct-DQ4_K
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 anikifoss/Kimi-K2-Instruct-DQ4_K # Run inference directly in the terminal: ./llama-cli -hf anikifoss/Kimi-K2-Instruct-DQ4_K
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 anikifoss/Kimi-K2-Instruct-DQ4_K # Run inference directly in the terminal: ./build/bin/llama-cli -hf anikifoss/Kimi-K2-Instruct-DQ4_K
Use Docker
docker model run hf.co/anikifoss/Kimi-K2-Instruct-DQ4_K
- LM Studio
- Jan
- vLLM
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "anikifoss/Kimi-K2-Instruct-DQ4_K" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "anikifoss/Kimi-K2-Instruct-DQ4_K", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/anikifoss/Kimi-K2-Instruct-DQ4_K
- Ollama
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with Ollama:
ollama run hf.co/anikifoss/Kimi-K2-Instruct-DQ4_K
- Unsloth Desktop
- Pi
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf anikifoss/Kimi-K2-Instruct-DQ4_K
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": "anikifoss/Kimi-K2-Instruct-DQ4_K" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with Docker Model Runner:
docker model run hf.co/anikifoss/Kimi-K2-Instruct-DQ4_K
- Lemonade
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull anikifoss/Kimi-K2-Instruct-DQ4_K
Run and chat with the model
lemonade run user.Kimi-K2-Instruct-DQ4_K-{{QUANT_TAG}}List all available models
lemonade list
- Hermes Agent
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf anikifoss/Kimi-K2-Instruct-DQ4_K
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 anikifoss/Kimi-K2-Instruct-DQ4_K
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use anikifoss/Kimi-K2-Instruct-DQ4_K with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf anikifoss/Kimi-K2-Instruct-DQ4_K
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 "anikifoss/Kimi-K2-Instruct-DQ4_K" \ --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"
Updaed Chat-Template
#4
by anikifoss - opened
Updated chate_template to the latest version, you can re-download Kimi-K2-Instruct-DQ4_K-00001-of-00014.gguf or manually apply the patch using instructions below.
cd $PATH_TO_COMPILED_LLAMA_CPP
cd gguf-py
python -m venv venv
source venv/bin/activate
pip install -r ../requirements/requirements-gguf_editor_gui.txt
pip install --editable .
cd $PATH_TO_KIMI_K2
mv Kimi-K2-Instruct-DQ4_K-00001-of-00014.gguf Kimi-K2-Instruct-DQ4_K-00001-of-00014.original.gguf
gguf-new-metadata \
--chat-template '{%- if tools -%}
<|im_system|>tool_declare<|im_middle|>{{ tools | tojson }}<|im_end|>
{%- endif -%}
{%- for message in messages -%}
{%- if loop.first and messages[0]['"'"'role'"'"'] != '"'"'system'"'"' -%}
<|im_system|>system<|im_middle|>You are Kimi, an AI assistant created by Moonshot AI.<|im_end|>
{%- endif -%}
{%- if message['"'"'role'"'"'] == '"'"'system'"'"' -%}
<|im_system|>system<|im_middle|>
{%- elif message['"'"'role'"'"'] == '"'"'user'"'"' -%}
<|im_user|>user<|im_middle|>
{%- elif message['"'"'role'"'"'] == '"'"'assistant'"'"' -%}
<|im_assistant|>assistant<|im_middle|>
{%- elif message['"'"'role'"'"'] == '"'"'tool'"'"' -%}
<|im_system|>tool<|im_middle|>
{%- endif -%}
{%- if message['"'"'role'"'"'] == '"'"'assistant'"'"' and message.get('"'"'tool_calls'"'"') -%}
{%- if message['"'"'content'"'"'] -%}{{ message['"'"'content'"'"'] }}{%- endif -%}
<|tool_calls_section_begin|>
{%- for tool_call in message['"'"'tool_calls'"'"'] -%}
{%- set formatted_id = tool_call['"'"'id'"'"'] -%}
<|tool_call_begin|>{{ formatted_id }}<|tool_call_argument_begin|>{% if tool_call['"'"'function'"'"']['"'"'arguments'"'"'] is string %}{{ tool_call['"'"'function'"'"']['"'"'arguments'"'"'] }}{% else %}{{ tool_call['"'"'function'"'"']['"'"'arguments'"'"'] | tojson }}{% endif %}<|tool_call_end|>
{%- endfor -%}
<|tool_calls_section_end|>
{%- elif message['"'"'role'"'"'] == '"'"'tool'"'"' -%}
## Return of {{ message.tool_call_id }}
{{ message['"'"'content'"'"'] }}
{%- elif message['"'"'content'"'"'] is string -%}
{{ message['"'"'content'"'"'] }}
{%- elif message['"'"'content'"'"'] is not none -%}
{% for content in message['"'"'content'"'"'] -%}
{% if content['"'"'type'"'"'] == '"'"'image'"'"' or '"'"'image'"'"' in content or '"'"'image_url'"'"' in content -%}
<|media_start|>image<|media_content|><|media_pad|><|media_end|>
{% else -%}
{{ content['"'"'text'"'"'] }}
{%- endif -%}
{%- endfor -%}
{%- endif -%}
<|im_end|>
{%- endfor -%}
{%- if add_generation_prompt -%}
<|im_assistant|>assistant<|im_middle|>
{%- endif -%}' \
Kimi-K2-Instruct-DQ4_K-00001-of-00014.original.gguf \
Kimi-K2-Instruct-DQ4_K-00001-of-00014.gguf