Instructions to use unsloth/Qwen3.8-Flash-Next-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 unsloth/Qwen3.8-Flash-Next-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 unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: llama cli -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: llama cli -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
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 unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: ./llama-cli -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
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 unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL # Run inference directly in the terminal: ./build/bin/llama-cli -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
Use Docker
docker model run hf.co/unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
- LM Studio
- Jan
- vLLM
How to use unsloth/Qwen3.8-Flash-Next-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "unsloth/Qwen3.8-Flash-Next-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": "unsloth/Qwen3.8-Flash-Next-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/unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
- Ollama
How to use unsloth/Qwen3.8-Flash-Next-GGUF with Ollama:
ollama run hf.co/unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
- Unsloth Desktop
- Pi
How to use unsloth/Qwen3.8-Flash-Next-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
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": "unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use unsloth/Qwen3.8-Flash-Next-GGUF with Docker Model Runner:
docker model run hf.co/unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
- Lemonade
How to use unsloth/Qwen3.8-Flash-Next-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
Run and chat with the model
lemonade run user.Qwen3.8-Flash-Next-GGUF-UD-Q4_K_XL
List all available models
lemonade list
- Hermes Agent
How to use unsloth/Qwen3.8-Flash-Next-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 unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
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 unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use unsloth/Qwen3.8-Flash-Next-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL
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 "unsloth/Qwen3.8-Flash-Next-GGUF:UD-Q4_K_XL" \ --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"
Getting 10+ tok/s on a 3060 laptop with 48GB RAM
My experience of the various quants on a 3060 laptop (VRAM modded to 12GB) with 48GB of DDR4-3200 system RAM.
Config (latest build of llama.cpp master):
./llama-server \
-a Qwen3.8-Flash-Next-UD-Q2_K_XL \
-m Qwen3.8-Flash-Next-UD-Q2_K_XL-00001-of-00003.gguf \
-mm mmproj-BF16.gguf \
-cmoe \
-cram 2048 \
-ctk q8_0 \
-ctv q8_0 \
-fit off \
-kvu \
-np 2 \
--min-p 0 \
--override-kv "qwen4exp.attention.indexer.top_k=int:4096" \
--temp 1 \
--top-k 20
Which uses 11.6GB of VRAM at full 256K context, achieving 10+ tok/s on decode and 40+ tok/s on prompt processing. Any larger quants would suffer significant speed degradation due to constant page faults. UD-Q4_K_XL for instance only achieves 5 tok/s decode and prompt processing takes FOREVER!
Tips to further reduce VRAM consumption:
--no-mmproj-offload (pins mmproj to the CPU)
-c 131072 (limits the context window)
-np 1 (limits to one concurrent task)
EDIT 1: -ub 1024 pushes pp to 60+ tok/s, but at the cost of more VRAM. I was able to stuff 256K context into 11.9GB with --no-mmproj-offload and -np 1, but it's too close to the VRAM ceiling for my liking. If you have 16GB VRAM, you can set -ub to 1024 or 2048 to get better pp speeds. MTP was also tested, but it didn't offer any meaningful improvements for my heavily CPU-offloaded config.
EDIT 2: Limited -cram to 2048MiB (default 8192) to prevent prompt cache from eating too much available RAM on long-horizon tasks.
EDIT 3: I was able to squeeze ~25% more decode speed using codacus' fork (https://github.com/thecodacus/llama.cpp), which takes advantage of unused VRAM by caching the most frequently used experts based on an MoE cache profile (which is much more intelligent than manually setting -ncmoe). I was still able to get 256K context, but at q4_0 KV quant with --no-mmproj-offload and -np 1. It now uses 11.8GB of VRAM with 42 cache slots. More slots would yield a more dramatic speedup, so this would work better on 16GB GPUs.
To get the profile:
MOE_TRACE_OUT=code.csv ./llama-moe-trace \
-m Qwen3.8-Flash-Next-UD-Q2_K_XL-00001-of-00003.gguf \
-c 4096 \
-cmoe \
-fit off \
-n 512 \
-p "Implement the game Snake in Python." \
--min-p 0 \
--override-kv "qwen4exp.attention.indexer.top_k=int:4096" \
--temp 1 \
--top-k 20; MOE_TRACE_OUT=chat.csv ./llama-moe-trace \
-m Qwen3.8-Flash-Next-UD-Q2_K_XL-00001-of-00003.gguf \
-c 4096 \
-cmoe \
-fit off \
-n 512 \
-p "What is model quantization?" \
--min-p 0 \
--override-kv "qwen4exp.attention.indexer.top_k=int:4096" \
--temp 1 \
--top-k 20; cat code.csv chat.csv > moe-cache-profile.csv; rm code.csv chat.csv
And the updated config:
./llama-server \
-a Qwen3.8-Flash-Next-UD-Q2_K_XL \
-m Qwen3.8-Flash-Next-UD-Q2_K_XL-00001-of-00003.gguf \
-mm mmproj-BF16.gguf \
-cmoe \
-cram 2048 \
-ctk q4_0 \
-ctv q4_0 \
-fit off \
-kvu \
-np 1 \
--min-p 0 \
--moe-cache-profile moe-cache-profile.csv \
--moe-cache-slots 42 \
--no-mmproj-offload \
--override-kv "qwen4exp.attention.indexer.top_k=int:4096" \
--temp 1 \
--top-k 20
Other findings:
- If available system RAM > ~half the model size, it would run almost as if it's fully loaded into RAM. It would be slower for the first minute or so after the model is freshly loaded, or when it's switching between experts (for example when it switches from reasoning to coding), but otherwise it would run at almost the same speed as fully loaded into RAM. There are enough cached weights that it's not constantly hitting page faults and slowing down the generation. Check you disk reads and GPU power consumption while running various quants to see which would work.
- There's a big jump in quality after UD-Q4_K_XL. The reasoning is shorter, and there are noticeably less hallucinations, even comparing with UD-IQ4_XS. Definitely go with this if you have >64GB RAM.
- Do not over-optimize, keep the configurations simple. Use -cmoe instead of manually setting -ncmoe if it's only partially loaded into RAM. Don't use ngram speculative decoding (hitches during generation due to slow prompt processing). Most optimizations are for configurations with large VRAM and fully RAM-loaded, which are not suitable for this config.
My experience of the various quants on a 3060 laptop (VRAM upgraded to 12GB) with 48GB of DDR4-3200 system RAM.
Current config (latest build of llama.cpp master):
./llama-server
-a Qwen3.8-Flash-Next-UD-Q2_K_XL
-m Qwen3.8-Flash-Next-UD-Q2_K_XL-00001-of-00003.gguf
-mm mmproj-BF16.gguf
-ctk q8_0
-ctv q8_0
-cmoe
-fit off
-kvu
-np 2
--min-p 0
--override-kv "qwen4exp.attention.indexer.top_k=int:4096"
--reasoning-effort medium
--temp 1
--top-k 20Which uses 11.6GB of VRAM at full 256K context, achieving 10+ tok/s on decode and 50+ tok/s on prompt processing. Any larger quants would suffer significant speed degradation due to constant page faults. UD-Q4_K_XL for instance only achieves 5 tok/s decode and prompt processing takes FOREVER!
Tips to further reduce VRAM consumption:
--no-mmproj-offload (pins mmproj to the CPU)
-c 131072 (limits the context window)
-np 1 (limits to one concurrent task)Other findings:
- If available system RAM > ~half the model size, it would run almost as if it's fully loaded into RAM. It would be slower for the first minute or so after the model is freshly loaded, or when it's switching between experts (for example when it switches from reasoning to coding), but otherwise it would run at almost the same speed as fully loaded into RAM. There are enough weights cached that it's not constantly hitting page faults and slowing down the generation. Check you disk reads and GPU power consumption while running various quants to see which would work.
- There's a big jump in quality after UD-Q4_K_XL. The reasoning is shorter, and there are noticeably less hallucinations, even comparing with UD-IQ4_XS. Definitely go with this if you have >64GB RAM.
- Do not over-optimize, keep the configurations simple. Use -cmoe instead of manually setting -ncmoe if it's only partially loaded into RAM. Don't use ngram speculative decoding (hitches during generation due to slow prompt processing). Most optimizations are for configurations with large VRAM and fully RAM-loaded, which are not suitable for this config.
Hmm good results, But Checkout ik llama cpp aswell :D

