Instructions to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF", filename="ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf", )
llm.create_chat_completion( 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" } } ] } ] ) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "bottlecapai/ThinkingCap-Qwen3.6-27B-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": "bottlecapai/ThinkingCap-Qwen3.6-27B-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/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
- Ollama
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with Ollama:
ollama run hf.co/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
- Unsloth Studio
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF to start chatting
- Pi
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
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": "bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat new
- OpenClaw new
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf bottlecapai/ThinkingCap-Qwen3.6-27B-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 "bottlecapai/ThinkingCap-Qwen3.6-27B-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"
- Docker Model Runner
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with Docker Model Runner:
docker model run hf.co/bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
- Lemonade
How to use bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.ThinkingCap-Qwen3.6-27B-GGUF-Q4_K_M
List all available models
lemonade list
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 bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Run Hermes
hermesbottlecapai/ThinkingCap-Qwen3.6-27B-GGUF
GGUF / llama.cpp quantizations of bottlecapai/ThinkingCap-Qwen3.6-27B — capability of Qwen3.6-27B with 50% less thinking tokens on average, achieved by finetuning Qwen3.6-27B (Qwen Team, 2026) with online reinforcement learning while preserving the original answer quality and style.
➡️ Full model description, evaluation results (multi-seed, statistically tested), recommended sampling params, and citation: see the main model card at bottlecapai/ThinkingCap-Qwen3.6-27B.
About GGUF and quantization
GGUF is a single-file model format for running LLMs locally with llama.cpp and compatible runtimes (Ollama, LM Studio, …). The quantized variants below store weights at reduced precision — e.g. ≈4.7 bits per weight for Q4_K_M instead of the 16-bit f16 source — cutting download size and memory severalfold at a small, measured quality cost.
Files
| File | Quant | Size |
|---|---|---|
ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf |
Q4_K_M | 15.7 GB |
ThinkingCap-Qwen3.6-27B-Q8_0.gguf |
Q8_0 | 27.1 GB |
ThinkingCap-Qwen3.6-27B-f16.gguf |
f16 | 50.9 GB |
mmproj-ThinkingCap-Qwen3.6-27B-f16.gguf |
mmproj (vision) | 0.9 GB |
f16 is the unquantized source; Q8_0 is near-lossless; Q4_K_M is the recommended size/quality balance for most local setups.
Usage (llama.cpp)
# pull a specific quant straight from the Hub and chat
llama-cli -hf bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M -p "Hi"
# or download one file and run it
huggingface-cli download bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf --local-dir .
llama-cli -m ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf -p "Hi"
Speculative decoding (MTP)
llama.cpp can run MTP (multi-token-prediction) self-speculative decoding on these GGUFs for a decode speed-up — no separate draft model needed. Add --spec-type draft-mtp when serving:
llama-server -hf bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF:Q4_K_M --spec-type draft-mtp
Set the draft length with --spec-draft-n-max (e.g. 4). Requires a recent llama.cpp build with MTP support.
Vision (image input)
ThinkingCap is a vision-language model. Image input needs the multimodal projector
mmproj-ThinkingCap-Qwen3.6-27B-f16.gguf (in this repo) loaded alongside a text GGUF — the
single f16 mmproj pairs with any of the quants above.
- LM Studio / Jan / Ollama, …: download the
mmproj-*.gguffrom this repo; LM Studio auto-detects it and enables the image (🖼️) button. - llama.cpp CLI:
huggingface-cli download bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF \
ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf mmproj-ThinkingCap-Qwen3.6-27B-f16.gguf --local-dir .
llama-mtmd-cli -m ThinkingCap-Qwen3.6-27B-Q4_K_M.gguf \
--mmproj mmproj-ThinkingCap-Qwen3.6-27B-f16.gguf --image photo.jpg -p "Describe this image."
- llama-server: add
--mmproj mmproj-ThinkingCap-Qwen3.6-27B-f16.ggufto expose an OpenAI-compatible vision endpoint.
Expected performance
From our internal serving-validation harness (llama.cpp, single-stream, temperature 0) on a fast N=100/dataset subset of MMLU-Pro (reasoning) and RealWorldQA (vision) — a quick quant-parity + decode-speed check, not the headline accuracy evals (for the multi-seed, statistically-tested results see the main model card).
Our three quants (f16/Q8_0/Q4_K_M) stay within subset noise of f16 on accuracy, and MTP self-speculative decoding (--spec-type draft-mtp, n=4) accepts ≈3.75 tokens per verify step — a ≈1.4–1.7× per-token decode speed-up on top of the finetune's ≈50% token savings. Q4_K_M + MTP (bold) is the recommended local config. For reference we also list unsloth's Dynamic GGUFs of the base model (UD-*): same llama.cpp path, but base-model quants — so they match base accuracy and reason ≈2× longer (none of the finetune's token savings).
median tokens = median completion length; task s = median tokens ÷ single-stream tok/s (real per-request time); speedup is vs the unquantized base model in standard decoding.
MMLU-Pro (reasoning)
| config | acc | median tokens | tok/s | task s | speedup | accept_len (n=4) |
|---|---|---|---|---|---|---|
| Qwen3.6-27B base · standard | 0.85 | 1890 | 57.4 | 32.9 | 1.00× | — |
| f16 · standard | 0.89 | 884 | 50.4 | 17.5 | 1.88× | — |
| f16 · MTP | 0.88 | 870 | 86.7 | 10.0 | 3.28× | 3.78 |
| Q8_0 · standard | 0.88 | 890 | 57.2 | 15.6 | 2.12× | — |
| Q8_0 · MTP | 0.86 | 856 | 99.4 | 8.6 | 3.82× | 3.77 |
| Q4_K_M · standard | 0.86 | 814 | 61.8 | 13.2 | 2.50× | — |
| Q4_K_M · MTP | 0.85 | 848 | 89.2 | 9.5 | 3.46× | 3.74 |
| unsloth UD-Q8_K_XL (base) · standard | 0.85 | 1896 | 54.5 | 34.8 | 0.95× | — |
| unsloth UD-Q8_K_XL (base) · MTP | 0.86 | 1925 | 98.2 | 19.6 | 1.68× | 3.74 |
| unsloth UD-Q4_K_XL (base) · standard | 0.84 | 1976 | 62.1 | 31.8 | 1.03× | — |
| unsloth UD-Q4_K_XL (base) · MTP | 0.83 | 1928 | 87.1 | 22.1 | 1.49× | 3.72 |
RealWorldQA (vision)
| config | acc | median tokens | tok/s | task s | speedup | accept_len (n=4) |
|---|---|---|---|---|---|---|
| Qwen3.6-27B base · standard | 0.74 | 556 | 57.4 | 9.7 | 1.00× | — |
| f16 · standard | 0.79 | 271 | 50.4 | 5.4 | 1.80× | — |
| f16 · MTP | 0.79 | 271 | 86.7 | 3.1 | 3.10× | 3.78 |
| Q8_0 · standard | 0.79 | 270 | 57.2 | 4.7 | 2.05× | — |
| Q8_0 · MTP | 0.78 | 273 | 99.4 | 2.7 | 3.53× | 3.77 |
| Q4_K_M · standard | 0.78 | 283 | 61.8 | 4.6 | 2.11× | — |
| Q4_K_M · MTP | 0.78 | 274 | 89.2 | 3.1 | 3.15× | 3.74 |
| unsloth UD-Q8_K_XL (base) · standard | 0.68 | 530 | 54.5 | 9.7 | 1.00× | — |
| unsloth UD-Q8_K_XL (base) · MTP | 0.69 | 550 | 98.2 | 5.6 | 1.73× | 3.74 |
| unsloth UD-Q4_K_XL (base) · standard | 0.65 | 655 | 62.1 | 10.5 | 0.92× | — |
| unsloth UD-Q4_K_XL (base) · MTP | 0.70 | 564 | 87.1 | 6.5 | 1.49× | 3.72 |
- Downloads last month
- 302,587
4-bit
8-bit
16-bit

Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp# Start a local OpenAI-compatible server: llama serve -hf bottlecapai/ThinkingCap-Qwen3.6-27B-GGUF: