Instructions to use nace-ai/Qwen3.8-Flash-Next-MLX-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use nace-ai/Qwen3.8-Flash-Next-MLX-4bit with MLX:
# Make sure mlx-vlm is installed # pip install --upgrade mlx-vlm from mlx_vlm import load, generate from mlx_vlm.prompt_utils import apply_chat_template from mlx_vlm.utils import load_config # Load the model model, processor = load("nace-ai/Qwen3.8-Flash-Next-MLX-4bit") config = load_config("nace-ai/Qwen3.8-Flash-Next-MLX-4bit") # Prepare input image = ["http://images.cocodataset.org/val2017/000000039769.jpg"] prompt = "Describe this image." # Apply chat template formatted_prompt = apply_chat_template( processor, config, prompt, num_images=1 ) # Generate output output = generate(model, processor, formatted_prompt, image) print(output) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use nace-ai/Qwen3.8-Flash-Next-MLX-4bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "nace-ai/Qwen3.8-Flash-Next-MLX-4bit"
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "nace-ai/Qwen3.8-Flash-Next-MLX-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent
How to use nace-ai/Qwen3.8-Flash-Next-MLX-4bit with Hermes Agent:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "nace-ai/Qwen3.8-Flash-Next-MLX-4bit"
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 nace-ai/Qwen3.8-Flash-Next-MLX-4bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use nace-ai/Qwen3.8-Flash-Next-MLX-4bit with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "nace-ai/Qwen3.8-Flash-Next-MLX-4bit"
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 "nace-ai/Qwen3.8-Flash-Next-MLX-4bit" \ --custom-provider-id mlx-lm \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Qwen3.8-Flash-Next, MLX 4-bit (mixed precision)
This is a quantized copy of Qwen/Qwen3.8-Flash-Next, made by the Qwen Team (Alibaba Group). Qwen designed and trained the model, and all credit for it goes to them. Nace AI only quantized the published weights to run on Apple silicon Macs. We did no training, fine-tuning or merging. This is not an official Qwen release, and Qwen has not reviewed it.
For the model itself (architecture, benchmarks, intended use, limitations), see Qwen's model card and the Qwen3.8-Flash-Next blog post.
- Source:
Qwen/Qwen3.8-Flash-Nextat revisionde4b8e4d43b917e7706784d8bb445c9af86a3540(bf16) - License: the Qwen Community License 1.0, unchanged from the source. Its terms apply to this copy as they do to the original. That includes condition 2: a Model-as-a-Service or AI Work Assistant business needs a separate license from Qwen for commercial use.
- Size: 106 GB on disk. About 73 GB of it goes in GPU memory: 71.4 GB of text model plus a 1.5 GB MTP head, and
the vision tower (0.9 GB) loads on the first image. The 32 GB n-gram embedding table (
ple.safetensors) is read from disk through memory mapping and never placed on the GPU. This needs a Mac with 128 GB of memory.
What was done
MLX affine quantization (scale and bias in bf16 per group). The precision of each tensor type was chosen by measuring each candidate against the bf16 model:
| Tensors | Format |
|---|---|
| Routed experts | 4-bit, group 64 |
Gated DeltaNet projections, shared experts, lm_head |
4-bit, group 64 |
Hyper-connection mixes, attention q/k/v/o_proj |
6-bit, group 64 |
Router, shared-expert gate, sparse-attention indexer, n-gram key/value projections, embed_tokens |
8-bit, group 64 |
| n-gram embedding table | 4-bit, group 32 |
| MTP head | experts 4-bit, router and other linears 8-bit |
Vision tower, norms, conv1d, A_log, dt_bias |
bf16, as published |
Rounding is not plain round-to-nearest. For each group the quantizer picks the best of a min-max grid, a symmetric grid and least-squares refits, after rounding scale and bias to bf16.
The layout follows mlx-vlm's qwen4_exp conventions:
- Norm weights stay zero-centred, as the source stores them.
- Fused experts are split into
switch_mlp.{gate,up,down}_proj. - The n-gram table is in
ple.safetensors, described byple_manifest.json. - The MTP head is in
mtp.safetensors.
conversion.json lists the source revision, the recipe, and every file's size and SHA-256.
Quality
Next-token distributions over 4 x 1,024 tokens of C++, Python, English prose and agent chat with tool calls, against the bf16 model run in fp32. KL is exact over the full 248,320-token vocabulary.
| Version | KL vs bf16 | Top-1 agreement | Perplexity (bf16: 4.054) | Decode bytes / token |
|---|---|---|---|---|
| bf16 weights, bf16 activations (noise floor) | 0.024 | 94.6% | 4.021 | 13.3 GB |
| This version | 0.129 | 86.8% | 4.109 | 4.13 GB |
| Uniform 4-bit, group 32, round-to-nearest | 0.232 | 83.6% | 4.335 | 4.21 GB |
| Uniform 4-bit, group 64, round-to-nearest | 0.288 | 81.6% | 4.527 | 3.79 GB |
This model is more sensitive to quantization than earlier Qwen MoE models. The 6-bit hyper-connections and attention account for most of the difference.
Running it
Made for Kapitsa, Nace AI's inference engine for Apple silicon. Support for this model comes in Kapitsa's next release:
kapitsa serve --model flash-next
The files also follow mlx-vlm's layout. We loaded them in mlx-vlm 0.7.8 to produce our reference outputs. mlx-vlm
drops the MTP head and reads the n-gram table through ple_manifest.json.
Citation
Please cite Qwen's work:
@techreport{qwen2026design,
title = {On the Design of {Qwen3.8-Next} Architecture: Evaluation, Efficiency, and Training Stability},
author = {{Qwen Team}},
institution = {Alibaba Group},
month = {August},
year = {2026}
}
@misc{qwen3.8flashnext,
title = {{Qwen3.8-Flash-Next}: A New Architecture, Towards Ultimate Cost-Efficiency},
author = {{Qwen Team}},
month = {August},
year = {2026},
url = {https://qwen.ai/blog?id=qwen3.8-flash-next}
}
- Downloads last month
- 1,501
4-bit
Model tree for nace-ai/Qwen3.8-Flash-Next-MLX-4bit
Base model
Qwen/Qwen3.8-Flash-Next