Instructions to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- llama-cpp-python
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with llama-cpp-python:
# !pip install llama-cpp-python from llama_cpp import Llama llm = Llama.from_pretrained( repo_id="localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF", filename="Qwen3.6-27B-MTP-IQ4_XS.gguf", )
llm.create_chat_completion( messages = "No input example has been defined for this model task." )
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with llama.cpp:
Install from brew
brew install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS # Run inference directly in the terminal: llama-cli -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama-server -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS # Run inference directly in the terminal: llama-cli -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
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 localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS # Run inference directly in the terminal: ./llama-cli -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
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 localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS # Run inference directly in the terminal: ./build/bin/llama-cli -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
Use Docker
docker model run hf.co/localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
- LM Studio
- Jan
- Ollama
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with Ollama:
ollama run hf.co/localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
- Unsloth Studio
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-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 localweights/Qwen3.6-27B-MTP-IQ4_XS-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 localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF to start chatting
Using HuggingFace Spaces for Unsloth
# No setup required # Open https://huggingface.co/spaces/unsloth/studio in your browser # Search for localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF to start chatting
- Pi
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
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": "localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama-server -hf localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
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 localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
Run Hermes
hermes
- Atomic Chat new
- Docker Model Runner
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with Docker Model Runner:
docker model run hf.co/localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
- Lemonade
How to use localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF:IQ4_XS
Run and chat with the model
lemonade run user.Qwen3.6-27B-MTP-IQ4_XS-GGUF-IQ4_XS
List all available models
lemonade list
Qwen3.6-27B-MTP-IQ4_XS-GGUF
Qwen3.6-27B with NextN/MTP (Multi-Token Prediction) speculative-decoding head, quantized to IQ4_XS for single-GPU 24GB inference.
What this is
The published Qwen3.6 family ships with native NextN MTP heads embedded in the safetensors. Most public GGUFs strip these. This conversion preserves them, producing a single GGUF that:
- Loads as
qwen35moe_mtparch in a patched llama.cpp - Serves at ~2ร decode speed vs. the same trunk without MTP
- Fits in ~15 GB VRAM at IQ4_XS + q4/q4 KV
- Native 262K context
Build pipeline
Source: Qwen/Qwen3.6-27B (HF safetensors, with NextN tensors).
- Clone llama.cpp at the
crucible-mtpbranch onllama.cpp (patched)(Aman Gupta's MTP fork) โ addsLLM_ARCH_QWEN35MOE_MTP+ the NextN draft path. - Run
convert_hf_to_gguf.pyagainst the HF repo. Produces a BF16 GGUF with archqwen35moe_mtpand the NextN tensors fused in. - Quantize to IQ4_XS via
llama-quantize.
python convert_hf_to_gguf.py /path/to/Qwen3.6-27B \
--outfile Qwen3.6-27B-MTP-bf16.gguf
llama-quantize Qwen3.6-27B-MTP-bf16.gguf \
Qwen3.6-27B-MTP-IQ4_XS.gguf IQ4_XS
Optimal serving config (RTX 3090 Ti, 24 GB)
Cherry-pick PRs #20819 + #20822 for cross-process KV-slot save/restore (we use these for sub-second resume on long contexts).
llama-server \
-m Qwen3.6-27B-MTP-IQ4_XS.gguf \
-ngl 999 -fa on \
--spec-type mtp --spec-draft-n-max 4 \
--no-mmap \
--ctx-size 262144 \
--batch-size 1024 --ubatch-size 512 \
-ctk q4_0 -ctv q4_0 \
--parallel 1 --kv-unified \
--ctx-checkpoints 8 --checkpoint-every-n-tokens 2048 \
--cache-ram -1 --cache-idle-slots \
--metrics --jinja
Why these flags:
--spec-type mtp: enables NextN-head draft path (this is the whole point of the MTP variant).--spec-draft-n-max 4: empirically the sweet spot โ beyond that, accept rate drops faster than draft count grows.--no-mmap: required for KV-slot persistence + measured ~no perf hit on this rig.-ctk q4_0 -ctv q4_0: dense KV cache fits 262K context inside 24 GB without spilling.--parallel 1: MTP path currently only supportsn_parallel=1upstream.
What NOT to set:
-ot(expert offload) โ defeats the GPU-resident speedup.-ctk q8_0at full 262K ctx โ overflows VRAM during warmup.
Performance (RTX 3090 Ti, 350 W power limit)
Measured 2026-05-06 at short-context inference, persistence + MTP on:
| Metric | Value |
|---|---|
| Decode tok/s (short ctx, no thinking) | 100.3 (live measured 2026-05-06, n=4 spec) |
| Decode tok/s (longer ramp 4Kโ256K ctx, mean) | 70โ73 |
| Draft accept rate (n=4) | 86.6% |
| Speedup vs same trunk without MTP | 2.92ร (33 โ 97 t/s on identical workload) |
| KV slot restore (typical 50 Kโ200 K ctx) | 0.16โ0.36 s |
| Cold load (model โ ready) | ~5โ6 s |
Memory footprint at 262 K ctx: ~17 GB (model) + ~5 GB (KV q4/q4) + scratch = ~22.5 GB used, ~1.5 GB headroom on a 24 GB card.
Tokenizer
Inherits Qwen3.6 tokenizer (248,320 vocab, qwen35 pre-tokenizer). Same chat template as upstream Qwen3.6-Instruct. If your runtime errors on Jinja Exception: System message must be at the beginning, use the loosened template at: https://huggingface.co/localweights/qwen36-loose-jinja (single line edit removing the strict-position assertion).
License
Apache 2.0 (inherited from Qwen3.6).
Provenance
Built on Crucible: 9950X / 96 GB DDR5 / RTX 3090 Ti. Same pipeline used for the sibling Qwen3.6-35B-A3B-MTP-IQ4_XS-GGUF repo.
- Downloads last month
- 734
4-bit
Model tree for localweights/Qwen3.6-27B-MTP-IQ4_XS-GGUF
Base model
Qwen/Qwen3.6-27B