Instructions to use WhiskyAKM/MiniCPM5-2B-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 WhiskyAKM/MiniCPM5-2B-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 WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
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 WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
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 WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use WhiskyAKM/MiniCPM5-2B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "WhiskyAKM/MiniCPM5-2B-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": "WhiskyAKM/MiniCPM5-2B-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
- Ollama
How to use WhiskyAKM/MiniCPM5-2B-GGUF with Ollama:
ollama run hf.co/WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use WhiskyAKM/MiniCPM5-2B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_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": "WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use WhiskyAKM/MiniCPM5-2B-GGUF with Docker Model Runner:
docker model run hf.co/WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
- Lemonade
How to use WhiskyAKM/MiniCPM5-2B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.MiniCPM5-2B-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use WhiskyAKM/MiniCPM5-2B-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 WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_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 WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use WhiskyAKM/MiniCPM5-2B-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_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 "WhiskyAKM/MiniCPM5-2B-GGUF:Q4_K_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"
| {{- bos_token }}{%- if tools %} | |
| {%- set tool_definitions %} | |
| {{- "# Tools\n\nYou are provided with function signatures within <tools></tools> XML tags:\n<tools>" }} | |
| {%- for tool in tools %} | |
| {{- "\n" }} | |
| {{- tool | tojson(ensure_ascii=False) }} | |
| {%- endfor %} | |
| {{- '\n</tools>\n\nTool usage guidelines:\n- You may call zero or more functions. If no function calls are needed, just answer normally and do not include any <function ... </function>.\n- When calling a function, return an XML object within <function ... </function> using:\n<function name="function-name"><param name="param-name">param-value</param></function>\n- param-value may be multi-line. If it contains <, & or newline characters, wrap it in a CDATA block: <param name="param-name"><![CDATA[...multi-line value...]]></param>' }} | |
| {%- endset %} | |
| {{- '<|im_start|>system\n' }} | |
| {%- if messages[0].role == 'system' %} | |
| {%- if '<tool_def_sep>' in messages[0].content %} | |
| {{- messages[0].content.replace('<tool_def_sep>', tool_definitions) }} | |
| {%- else %} | |
| {{- messages[0].content + '\n\n' + tool_definitions }} | |
| {%- endif %} | |
| {%- else %} | |
| {{- tool_definitions.lstrip() }} | |
| {%- endif %} | |
| {{- '<|im_end|>\n' }} | |
| {%- else %} | |
| {%- if messages[0].role == 'system' %} | |
| {{- '<|im_start|>system\n' + messages[0].content + '<|im_end|>\n' }} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- set ns = namespace(multi_step_tool=true, last_query_index=messages|length - 1) %} | |
| {%- for message in messages[::-1] %} | |
| {%- set index = (messages|length - 1) - loop.index0 %} | |
| {%- if ns.multi_step_tool and message.role == "user" and message.content is string and not(message.content.startswith('<tool_response>') and message.content.endswith('</tool_response>')) %} | |
| {%- set ns.multi_step_tool = false %} | |
| {%- set ns.last_query_index = index %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- for message in messages %} | |
| {%- if message.content is string %} | |
| {%- set content = message.content %} | |
| {%- else %} | |
| {%- set content = '' %} | |
| {%- endif %} | |
| {%- if (message.role == "user") or (message.role == "system" and not loop.first) %} | |
| {{- '<|im_start|>' + message.role + '\n' + content + '<|im_end|>' + '\n' }} | |
| {%- elif message.role == "assistant" %} | |
| {%- set reasoning_content = '' %} | |
| {%- if message.reasoning_content is string %} | |
| {%- set reasoning_content = message.reasoning_content %} | |
| {%- else %} | |
| {%- if '</think>' in content %} | |
| {%- set reasoning_content = content.split('</think>')[0].rstrip('\n').split('<think>')[-1].lstrip('\n') %} | |
| {%- set content = content.split('</think>')[-1].lstrip('\n') %} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- if message.tool_calls %} | |
| {%- set content_parts = content.split('<tool_sep>') %} | |
| {%- set processed_content = content_parts[0] %} | |
| {%- set tool_calls_count = message.tool_calls|length %} | |
| {%- set tool_sep_count = content_parts|length - 1 %} | |
| {%- set min_count = [tool_calls_count, tool_sep_count]|min %} | |
| {%- for i in range(1, content_parts|length) %} | |
| {%- set tool_index = i - 1 %} | |
| {%- if tool_index < tool_calls_count %} | |
| {%- set tool_call = message.tool_calls[tool_index] %} | |
| {%- if tool_call.function %} | |
| {%- set tool_call = tool_call.function %} | |
| {%- endif %} | |
| {%- set single_tool_xml %} | |
| {{- '<function name="' ~ tool_call.name ~ '">' }} | |
| {%- if tool_call.arguments %} | |
| {%- set args_dict = tool_call.arguments %} | |
| {%- for param_name, param_value in args_dict.items() %} | |
| {{- '<param name="' ~ param_name ~ '">' }} | |
| {%- if param_value is string and ('<' in param_value or '&' in param_value or '\n' in param_value) %} | |
| {{- '<![CDATA[' + param_value + ']]>' }} | |
| {%- else %} | |
| {{- param_value }} | |
| {%- endif %} | |
| {{- '</param>' }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '</function>' }} | |
| {%- endset %} | |
| {%- set processed_content = processed_content + single_tool_xml + content_parts[i] %} | |
| {%- else %} | |
| {%- set processed_content = processed_content + content_parts[i] %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- if tool_calls_count > tool_sep_count %} | |
| {%- for remaining_index in range(tool_sep_count, tool_calls_count) %} | |
| {%- set tool_call = message.tool_calls[remaining_index] %} | |
| {%- if tool_call.function %} | |
| {%- set tool_call = tool_call.function %} | |
| {%- endif %} | |
| {%- set remaining_tool_xml %} | |
| {{- '<function name="' ~ tool_call.name ~ '">' }} | |
| {%- if tool_call.arguments %} | |
| {%- set args_dict = tool_call.arguments %} | |
| {%- for param_name, param_value in args_dict.items() %} | |
| {{- '<param name="' ~ param_name ~ '">' }} | |
| {%- if param_value is string and ('<' in param_value or '&' in param_value or '\n' in param_value) %} | |
| {{- '<![CDATA[' + param_value + ']]>' }} | |
| {%- else %} | |
| {{- param_value }} | |
| {%- endif %} | |
| {{- '</param>' }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '</function>' }} | |
| {%- endset %} | |
| {%- set processed_content = processed_content + remaining_tool_xml %} | |
| {%- endfor %} | |
| {%- endif %} | |
| {%- set content = processed_content %} | |
| {%- endif %} | |
| {%- if reasoning_content %} | |
| {{- '<|im_start|>' + message.role + '\n<think>\n' + reasoning_content.strip('\n') + '\n</think>\n\n' + content.lstrip('\n') }} | |
| {%- elif '<think>' not in content and '</think>' not in content %} | |
| {{- '<|im_start|>' + message.role + '\n<think>\n\n</think>\n\n' + content.lstrip('\n') }} | |
| {%- else %} | |
| {{- '<|im_start|>' + message.role + '\n' + content }} | |
| {%- endif %} | |
| {%- if message.tool_calls and not has_tool_sep %} | |
| {%- for tool_call in message.tool_calls %} | |
| {%- if (loop.first and content) or (not loop.first) %} | |
| {{- '\n' }} | |
| {%- endif %} | |
| {%- if tool_call.function %} | |
| {%- set tool_call = tool_call.function %} | |
| {%- endif %} | |
| {{- '<function name="' ~ tool_call.name ~ '">' }} | |
| {%- if tool_call.arguments %} | |
| {%- set args_dict = tool_call.arguments %} | |
| {%- for param_name, param_value in args_dict.items() %} | |
| {{- '<param name="' ~ param_name ~ '">' }} | |
| {%- if param_value is string and ('<' in param_value or '&' in param_value or '\n' in param_value) %} | |
| {{- '<![CDATA[' + param_value + ']]>' }} | |
| {%- else %} | |
| {{- param_value }} | |
| {%- endif %} | |
| {{- '</param>' }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '</function>' }} | |
| {%- endfor %} | |
| {%- endif %} | |
| {{- '<|im_end|>\n' }} | |
| {%- elif message.role == "tool" %} | |
| {%- if loop.first or (messages[loop.index0 - 1].role != "tool") %} | |
| {{- '<|im_start|>user' }} | |
| {%- endif %} | |
| {{- '\n<tool_response>\n' }} | |
| {%- if message.content is string %} | |
| {{- content }} | |
| {%- else %} | |
| {{- message.content | tojson(ensure_ascii=False) }} | |
| {%- endif %} | |
| {{- '\n</tool_response>' }} | |
| {%- if loop.last or (messages[loop.index0 + 1].role != "tool") %} | |
| {{- '<|im_end|>\n' }} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- endfor %} | |
| {%- if add_generation_prompt %} | |
| {{- '<|im_start|>assistant\n' }} | |
| {%- if enable_thinking is defined %} | |
| {%- if enable_thinking is false %} | |
| {{- '<think>\n\n</think>\n\n' }} | |
| {%- elif enable_thinking is true %} | |
| {{- '<think>\n' }} | |
| {%- endif %} | |
| {%- endif %} | |
| {%- endif %} | |