Instructions to use bottlecapai/ThinkingCap-Qwen3.8-27B-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 bottlecapai/ThinkingCap-Qwen3.8-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.8-27B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf bottlecapai/ThinkingCap-Qwen3.8-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.8-27B-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf bottlecapai/ThinkingCap-Qwen3.8-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.8-27B-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf bottlecapai/ThinkingCap-Qwen3.8-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.8-27B-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M
Use Docker
docker model run hf.co/bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use bottlecapai/ThinkingCap-Qwen3.8-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.8-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.8-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.8-27B-GGUF:Q4_K_M
- Ollama
How to use bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF with Ollama:
ollama run hf.co/bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use bottlecapai/ThinkingCap-Qwen3.8-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.8-27B-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": "bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF with Docker Model Runner:
docker model run hf.co/bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M
- Lemonade
How to use bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull bottlecapai/ThinkingCap-Qwen3.8-27B-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.ThinkingCap-Qwen3.8-27B-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use bottlecapai/ThinkingCap-Qwen3.8-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.8-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.8-27B-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use bottlecapai/ThinkingCap-Qwen3.8-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.8-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.8-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"
Can you guys supply the Q5_K_M version?
I LOVE testing our your LLMs guys so let me just start by giving you props for the work you are doing.
I have a headless server PC with a RTX 4090 so I can USUALLY fit the Q5_K_M variant well since I do not have the large OS desktop overhead which frees up more VRAM.
If was wondering if you guys have the resources/time if you could output a Q5_K_M variant? I'm sure there are others who would greatly appreciate it besides me!
Keep up the inventive work!
We'll look into it 🙂
Hi, have you considered Q4_K_M?
AFAIK it is performing very decent - we aimed at keeping as much performance as possible and we also made sure it is not prolonging reasoning.
In my opinion it should be faster than Q5_K_M, it is not purely memory tradeoff at least for single request on RTX4090.
What do you expect the Q5_K_M to solve what Q4_K_M does not have?
Fair question. My understanding is that a higher quant stays closer to what the full unquantized model would output for the same prompt. So I figured Q5_K_M would lose a little less quality, especially on longer or trickier reasoning. If your testing shows Q4_K_M holds up that well, I'm happy to stick with it. Thanks for explaining!
Some numbers on what Q5_K_M would buy you on a 24 GB card. The Q4_K_M and Q6_K files here are within a few hundred bytes of ukisai's Swift-1.5-Qwen3.8-27B quants (17,442,400,352 vs 17,442,399,936 and 23,860,566,112 vs 23,860,565,696 bytes), so their Q5_K_M (20,923,877,056 bytes = 19.49 GiB) is a good predictor for a ThinkingCap Q5_K_M.
The KV cache is small for this architecture because only 16 of the 64 layers are full attention (the other 48 keep a fixed-size recurrent state): 16 × 4 KV heads × 256 × 2 (K,V) × 2 bytes = 64 KiB/token in f16, 34 KiB/token with q8_0. The files also carry the MTP layer (nextn_predict_layers = 1, blk.64). If you run it with --spec-type draft-mtp, that's one more attention layer, so 68 KiB/token.
On 24 GiB, budgeting 0.5 GiB of runtime plus 10% for compute buffers:
- Q4_K_M (16.24 GiB): ~83K context in f16, ~157K with q8_0 KV
- Q5_K_M (~19.49 GiB): ~30K in f16, ~57K with q8_0
- Q6_K (22.22 GiB): leaves 1.78 GiB for KV, compute buffers and the CUDA context, which is too tight for useful context
So on a headless 4090, Q5_K_M works if ~32K f16 or ~56K q8_0 is enough, and Q4_K_M is the one that keeps long context. The 10% is on the conservative side. llama.cpp's --fit keeps 1024 MiB free by default and may get a bit more out of it.
Disclosure: I maintain this free calculator, and the Qwen3.8 27B page has the same numbers for other cards: https://modelvram.com/llm-vram-calculator/qwen3.8-27b/
If you look closely, you'll notice that this isn't a standard Q4_K_M.🤔😀