Instructions to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp 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 AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp 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 AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16 # Run inference directly in the terminal: llama cli -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16 # Run inference directly in the terminal: llama cli -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
Build from source code
git clone https://github.com/ggml-org/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-app # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama serve -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16 # Run inference directly in the terminal: ./build/bin/llama cli -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
Use Docker
docker model run hf.co/AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
- Llama new
- LM Studio
- Jan
- Ollama
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with Ollama:
ollama run hf.co/AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
- Unsloth Desktop
- Pi
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
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": "AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with Docker Model Runner:
docker model run hf.co/AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
- Lemonade
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
Run and chat with the model
lemonade run user.Qwen3.8-27B-AX8860-llama.cpp-BF16
List all available models
lemonade list
- Hermes Agent
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
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 AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16
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 "AXERA-TECH/Qwen3.8-27B-AX8860-llama.cpp:BF16" \ --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"
YAML Metadata Warning:empty or missing yaml metadata in repo card
Check out the documentation for more information.
Qwen3.8-27B on AX8860 (llama.cpp + ggml-axera)
ๅจ็ฑ่ฏ AX8860 ็ NPU ไธ็จ llama.cpp ่ฟ่ก Qwen3.8-27B๏ผๆๆฌ + ๅพๅ่พๅ ฅ๏ผๆ้ฟ 256k ไธไธๆ๏ผMTP ๆๆบ่งฃ็ ๏ผOpenAI ๅ ผๅฎนๆๅกใ Qwen3.8-27B on the Axera AX8860 NPU with llama.cpp: text + image input, up to 256k context, MTP speculative decoding, OpenAI-compatible server.
ๆง่ฝ / Performance
| decode | 13.8 tokens/s |
| decode๏ผMTP ๆๆบ่งฃ็ / with MTP | ๆ้ซ / up to 33.0 tokens/s |
| 4k prompt prefill | 1249 tokens/s๏ผ3908 token 3.13 s๏ผ |
| ไธไธๆ / context | ๆ้ฟ / up to 262144 |
MTP๏ผMTP=1๏ผๆๅ
ๅฎน / by content๏ผ
| ๅ ๅฎน / content | ๆฎ้ / plain | MTP | ๅ ้ / speed-up |
|---|---|---|---|
| ไปฃ็ / code | 13.9 | 33.0 | 2.38x |
| ไธญ่ฏ่ฑ / translation | 13.8 | 26.8 | 1.94x |
| Markdown ่กจๆ ผ / table | 13.8 | 30.8 | 2.24x |
| ๆฐๅญฆ่งฃ้ข / maths | 13.8 | 30.9 | 2.23x |
| ไธญๆ็ญๆ / Chinese essay | 13.8 | 19.2 | 1.39x |
| ่ฑๆๆ ไบ / English story | 13.8 | 21.2 | 1.54x |
| ไปฃ็ ๏ผๆจ่้ๆ ท / code, sampled | 13.7 | 28.4 | 2.07x |
| ไธญๆ็ญๆ๏ผๆจ่้ๆ ท / essay, sampled | 13.7 | 18.9 | 1.38x |
ๅไฝ tokens/s๏ผๆฏ้กนๆๅค็ๆ 256 token๏ผๆชๆณจๆ็ไธบ่ดชๅฟ่งฃ็ / tokens/s; up to 256 tokens each, greedy unless noted.
sh bench.sh ๅค็ฐ / reproduce๏ผ็ๆ 128 token / 128 generated tokens๏ผ๏ผ
| prompt | -c |
prompt ่ๆถ / time | decode tokens/s |
|---|---|---|---|
| 5 token | 8192 | 0.24 s | 13.8 |
| 47 token | 8192 | 0.25 s | 13.8 |
| 3908 token | 8192 | 3.13 s | 13.5 |
| 3908 token | 16384 | 3.13 s | 13.5 |
| 3908 token๏ผๆจ่้ๆ ท / sampled | 8192 | 3.12 s | 13.3 |
ๅฟซ้ๅผๅง / Quick start
sh run.sh "The capital of France is" 64 # ๆๆฌ / text
sh run.sh -i bus.jpg "Describe this image." 256 # ๅพๅ / image
sh run.sh -c # ๅฝไปค่กๅฏน่ฏ / chat
sh run.sh -s 8080 # OpenAI ๅ
ผๅฎนๆๅก / server
MTP=1 sh run.sh -s 8080 # MTP ๆๆบ่งฃ็ / speculative decoding
CTX=131072 sh run.sh -s 8080 # ้ฟไธไธๆ / long context (default 16384)
sh bench.sh # ๆง่ฝๅค็ฐ / benchmark
้่ฆ AX8860๏ผSDK V0.5.1 ๆๆดๆฐ๏ผHF ไธ่ฝฝ็ๆไปถๆฒกๆๆง่กๆ้๏ผ็จ sh ่ฐ็จๅณๅฏ / needs an AX8860 with SDK V0.5.1+; call the scripts with sh.
ๆไปถ / Files
| ๆไปถ / File | ่ฏดๆ / Description |
|---|---|
qwen3.8-27b-mxfp4.gguf |
ๆจกๅๆ้ / weights๏ผ14.8 GB๏ผmd5 32f5a603d4f75edb16ccf7ff3a35bdd6 |
mmproj-qwen3.8-27b-bf16.gguf |
่ง่ง็ผ็ ๅจ / vision encoder๏ผ931 MB๏ผmd5 d2b989d06a0eb9109bab182ec2ff03f2 |
bin/ |
llama.cpp ๆฟ็ซฏ็จๅบ๏ผ้ๆ้พๆฅ๏ผ/ board programs (static) |
kernels/ |
NPU kernel + manifest.json |
run.sh๏ผchat_template.jinja |
่ฟ่ก่ๆฌไธๆๅก็ซฏๅฏน่ฏๆจกๆฟ / run script and the server's chat template |
bench.sh ๅ prompt |
ๆง่ฝๅค็ฐ / benchmark |
่ฏดๆ / Notes
- ๆๅก็ซฏ้ป่ฎคไฝฟ็จๆจกๅๅกๆจ่็้ๆ ทๅๆฐ๏ผๆๆฌ่กฅๅ จไธๅพๅๆ่ฟฐไธบ่ดชๅฟ่งฃ็ / the server uses the model card's recommended sampling; completion and image description are greedy.
- ๆๅก็ซฏ้ป่ฎคๅ
ณ้ญๆ่๏ผ
--reasoning off๏ผ๏ผๅนถๅ ่ฎธๅฏน่ฏไธญๆฎต็ system ๆถๆฏ๏ผCodex ็ญ agent ๅฎขๆท็ซฏๅฏ็จ๏ผ/ the server does not think by default and accepts a mid-conversation system message (works with agent clients such as Codex). - Prompt cache ้ป่ฎคๆพๅจ 4 GB ๅ
ๅญ๏ผ่ฎพ็ฝฎ
CACHE_DIR=<SSD ็ฎๅฝ>ๅฏ่ฝ็๏ผ้ๅฏๅไป่ฝๅฝไธญ / the prompt cache lives in 4 GB of host memory; setCACHE_DIR=<an SSD directory>to keep it on disk across restarts. - MTP ๆฏ่ฝฎ็ 3 ไธช token๏ผ็ฑ็ฎๆ ๆจกๅ้ไธช้ช่ฏ๏ผ่ดชๅฟๆถ่พๅบไธๆฎ้่งฃ็ ไธ่ด / MTP drafts 3 tokens per round, each verified by the target model; greedy output equals plain decoding.
- ่ฟ่กๆถ็ฌๅ NPU 4 ๆ ธ๏ผๆๅก็ซฏ
-np 1/ takes all 4 NPU cores; the server runs-np 1. llama-benchๅฏ็จ๏ผ่ฏทๅ-b 4096 -ub 4096/llama-benchworks; pass-b 4096 -ub 4096.- ไธชๅซ็ฏๅขไธ่ฟ็ปญ่ฏทๆฑๅถๅ
ret = -3๏ผ้่ฏๅณๅฏ / in rare cases a back-to-back request fails withret = -3; retry it.
ๆญฃ็กฎๆง / Correctness
- "The capital of France is" ็่ดชๅฟ่พๅบไธไธไธ็้ๅญ่็ธๅ๏ผๅพๅๆ่ฟฐๆญฃ็กฎ๏ผ่ฝฆ่พใๆๅญใไบบ็ฉ๏ผ/ the greedy output of "The capital of France is" is byte-identical to the previous release; image descriptions correct.
- ไธญๆ PPL๏ผๅ
้จๆต่ฏ้๏ผ
-c 512 --chunks 2๏ผ๏ผprefill 8.84๏ผ้ token decode๏ผ-b 1๏ผ8.83๏ผๆๆบ่งฃ็ ็ 4 ่ก้ช่ฏ๏ผ-ub 4๏ผ8.82๏ผไธไธ็ๅๆกไปถ prefill 8.83๏ผdecode 8.73 / Chinese PPL on an internal set: 8.84 through the prefill, 8.83 token by token, 8.82 through the 4-row verification; the previous release: 8.83 / 8.73. - ๆๆบ่งฃ็ ็่พๅบไธๆฎ้่ดชๅฟ่งฃ็ ไธ่ด๏ผๆฏไธช่็จฟ token ้ฝ็ป็ฎๆ ๆจกๅ้ช่ฏ๏ผ/ speculative decoding gives the same output as plain greedy decoding (every draft token is verified by the target model).
ๆบ็ / Sources
- llama.cpp๏ผZHEQIUSHUI/llama.cpp
axera-dev@aea9714 - kernel๏ผZHEQIUSHUI/ax-dsl-kernels
main@cd3394b๏ผmodels/qwen38_27b๏ผ
ๆดๆฐ / Changelog
- 2026-11-07๏ผprefill ๆ้๏ผ4k ็บฆ 1250 tokens/s๏ผ๏ผMTP ๆนไธบๅฏ้๏ผ
MTP=1๏ผ๏ผCTX้ป่ฎค 16384๏ผๆๅก็ซฏๅ ผๅฎนไธญๆฎต system ๆถๆฏใ้ป่ฎคๅ ณ้ญๆ่ใprompt cache ๅฏ่ฝ็ๅฐ SSD๏ผNPU ้ๆ ท๏ผๆฐๅขbench.sh/ server accepts mid-conversation system messages, no thinking by default, prompt cache on SSD; NPU sampling;bench.sh.
- Downloads last month
- 1,515
4-bit