Instructions to use AtomicChat/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 AtomicChat/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 AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf AtomicChat/Qwen3.8-Flash-Next-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 AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M # Run inference directly in the terminal: llama cli -hf AtomicChat/Qwen3.8-Flash-Next-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 AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M # Run inference directly in the terminal: ./llama-cli -hf AtomicChat/Qwen3.8-Flash-Next-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 AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M # Run inference directly in the terminal: ./build/bin/llama-cli -hf AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
Use Docker
docker model run hf.co/AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
- LM Studio
- Jan
- vLLM
How to use AtomicChat/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 "AtomicChat/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": "AtomicChat/Qwen3.8-Flash-Next-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
- Ollama
How to use AtomicChat/Qwen3.8-Flash-Next-GGUF with Ollama:
ollama run hf.co/AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
- Unsloth Desktop
- Pi
How to use AtomicChat/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 AtomicChat/Qwen3.8-Flash-Next-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": "AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use AtomicChat/Qwen3.8-Flash-Next-GGUF with Docker Model Runner:
docker model run hf.co/AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
- Lemonade
How to use AtomicChat/Qwen3.8-Flash-Next-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
Run and chat with the model
lemonade run user.Qwen3.8-Flash-Next-GGUF-Q4_K_M
List all available models
lemonade list
- Hermes Agent
How to use AtomicChat/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 AtomicChat/Qwen3.8-Flash-Next-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 AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use AtomicChat/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 AtomicChat/Qwen3.8-Flash-Next-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 "AtomicChat/Qwen3.8-Flash-Next-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"
it works great on M1 Max 64GB
Been testing for the past few hours, will continue to. Running AtomicChat/Qwen3.8-Flash-Next-GGUF:Q4_K_M on a Macbook M1 Max 64gb, it gets 11/17 tok/s depending on the size of the used context (I'm going with 65k), the performance is good enough to let it run in background while I'm working on other things, and it seems to be quite great!
I've been testing qwen3.8 27B 4bit as well, I'll try to give both the same requests, this one seems to be both faster and better, thank you!
Adding an M2 Max data point, and one thing that may explain your 11β17 spread.
M2 Max, 64 GB, AD-3.84bpw-IQ4_XS-M64 β llama-server -ngl 99 -fit off -np 1, build b10698:
context prefill decode
8k 309.0 22.9
32k 308.2 20.2
128k 306.6 20.2
256k fails, Metal OOM
Prefill on a 5 000-token prompt, three runs within 0.2 %; decode streamed over 400 tokens. Steady from the first tokens β no warm-up ramp.
Two things that mattered on 64 GB:
The wired limit. sudo sysctl iogpu.wired_limit_mb=53248 (52 GB). Default is lower and -ngl 99 then fails; the weights want ~46 GB in Metal. Measured with vm_stat "Pages wired down" β footprint reports ~1.8 GB for this process and misses Metal buffers entirely.
The variant. You are on Q4_K_M, which is ~55 GB of weights. That does not fit under a 52 GB limit, and a spread of 11β17 tok/s by context is what memory pressure looks like. IQ4_XS is ~46 GB and sits inside it β that may be worth more to you than the extra 0.4 bpw.
-fa auto already picks flash attention here, and -b/-ub 2048 exceeds the limit. --spec-type ngram-simple gave about +12 % decode on code-editing prompts at no memory cost.
Hi @grokked-it , I also observed a sharp generation speed drop strictly correlated with the used context on the M4 Max 64GB and it my case it's linear. See my post https://huggingface.co/AtomicChat/Qwen3.8-Flash-Next-GGUF/discussions/13.
RE: @Blackbeard82 - memory could be a factor due to the model architecture but it wasn't in my experiment. In one of my trials with a small -c and a very conservative iogpu.wired_limit_mb at 56GB (my OS and server stack takes 3GB) my memory usage was stable at 60GB and there was no swapping, yet I still got the linear generation speed drop.
context prefill decode
8k 309.0 22.9
32k 308.2 20.2
128k 306.6 20.2
256k fails, Metal OOM
are these prefill speed all for the 5000 tokens prefill at different context length limit settings? curious to see a test with your set up for input and output speed at different context length actually consumed :)
Good catch β you were right, and I have measured it properly now.
Those were context limit settings, not consumed context. Same ~5 000-token prompt in every row; only -c changed. And worse, the 8k row came from a different run with a short prompt, so it was not comparable to the other three at all.
Here is the actual curve on M2 Max 64 GB, same server, prompt length varied, 220 tokens generated each time:
prompt tokens prefill t/s decode t/s
1 188 291.0 21.7
5 808 302.6 19.7
17 464 261.8 16.5
34 894 220.5 13.2
So your observation holds: decode falls with consumed context, about 39 % from 1k to 35k, and prefill falls with it. Memory was steady throughout β no swap, no growth in wired pages β so I would agree with you that memory is not the mechanism.
One thing that may be worth trying on your M4 Max, since it costs nothing: --spec-type ngram-mod. On a copy-heavy task (return a file with one line changed) it took decode from 22.1 to 54.5 t/s here, with byte-identical output. It only helps when the output repeats the prompt, but that is most of what code editing is.