Instructions to use ggml-org/Inkling-2-Mini-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 ggml-org/Inkling-2-Mini-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 ggml-org/Inkling-2-Mini-GGUF:BF16 # Run inference directly in the terminal: llama cli -hf ggml-org/Inkling-2-Mini-GGUF:BF16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf ggml-org/Inkling-2-Mini-GGUF:BF16 # Run inference directly in the terminal: llama cli -hf ggml-org/Inkling-2-Mini-GGUF:BF16
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 ggml-org/Inkling-2-Mini-GGUF:BF16 # Run inference directly in the terminal: ./build/bin/llama cli -hf ggml-org/Inkling-2-Mini-GGUF:BF16
Use Docker
docker model run hf.co/ggml-org/Inkling-2-Mini-GGUF:BF16
- Llama new
- LM Studio
- Jan
- vLLM
How to use ggml-org/Inkling-2-Mini-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "ggml-org/Inkling-2-Mini-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": "ggml-org/Inkling-2-Mini-GGUF", "messages": [ { "role": "user", "content": [ { "type": "text", "text": "Describe this image in one sentence." }, { "type": "image_url", "image_url": { "url": "https://cdn.britannica.com/61/93061-050-99147DCE/Statue-of-Liberty-Island-New-York-Bay.jpg" } } ] } ] }'Use Docker
docker model run hf.co/ggml-org/Inkling-2-Mini-GGUF:BF16
- Ollama
How to use ggml-org/Inkling-2-Mini-GGUF with Ollama:
ollama run hf.co/ggml-org/Inkling-2-Mini-GGUF:BF16
- Unsloth Desktop
- Pi
How to use ggml-org/Inkling-2-Mini-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf ggml-org/Inkling-2-Mini-GGUF:BF16
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:9931/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "ggml-org/Inkling-2-Mini-GGUF:BF16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use ggml-org/Inkling-2-Mini-GGUF with Docker Model Runner:
docker model run hf.co/ggml-org/Inkling-2-Mini-GGUF:BF16
- Lemonade
How to use ggml-org/Inkling-2-Mini-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull ggml-org/Inkling-2-Mini-GGUF:BF16
Run and chat with the model
lemonade run user.Inkling-2-Mini-GGUF-BF16
List all available models
lemonade list
- Hermes Agent
How to use ggml-org/Inkling-2-Mini-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 ggml-org/Inkling-2-Mini-GGUF:BF16
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:9931/v1 hermes config set model.default ggml-org/Inkling-2-Mini-GGUF:BF16
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use ggml-org/Inkling-2-Mini-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf ggml-org/Inkling-2-Mini-GGUF:BF16
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:9931/v1 \ --custom-model-id "ggml-org/Inkling-2-Mini-GGUF:BF16" \ --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"
Inkling 2 Mini
Run with https://llama.app
llama serve -hf ggml-org/Inkling-2-Mini-GGUF:IQ4_NL
Source models
Files
| Quant | Size | Notes |
|---|---|---|
| BF16 | 52.2 GB | Original precision. The NVFP4 and MXFP8 experts of the checkpoint are stored as BF16 |
| Q8_0 | 27.8 GB | Near-lossless. All weight matrices at Q8_0 |
| IQ4_NL | 17.6 GB | imatrix-calibrated. 4-bit experts in layers 0-19, everything else at Q8_0 |
| mmproj (BF16, Q8_0) | 642 / 346 MB | Vision encoder |
Notes
- Inkling 2 Mini is a looped mixture-of-experts model (128 experts, 8 active per token) with image input. It has 24 layers: layers 6-17 form a loop core that runs 3 times per token, so each token goes through 48 layer evaluations with the weights of 24. Each pass keeps its own KV and convolution cache.
- The original checkpoint stores the routed experts of layers 0-19 in NVFP4 and those of layers 20-23 in MXFP8. The IQ4_NL output quantizes the NVFP4 experts (
ffn_gate_up_exps,ffn_down_expsof layers 0-19) to IQ4_NL and keeps all other weight matrices at Q8_0. The loop controller weights stay at F32. - The IQ4_NL is calibrated with an imatrix computed from the BF16 on bartowski's v6 calibration data, with the conversations rendered through the model's chat template.
- KL divergence against the BF16 on wikitext-2 (40 x 512 tokens): Q8_0 0.0030 (97.6% same top token), IQ4_NL 0.0095 (95.5% same top token).
- Reasoning depth is set with
reasoning_effort:none,minimal,low,medium,high(the default),xhighormax, or a number from 0.0 to 0.99.
- Downloads last month
- -
Hardware compatibility
Log In to add your hardware
Model tree for ggml-org/Inkling-2-Mini-GGUF
Base model
thinkingmachines/Inkling-2-Mini