Instructions to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit with MLX:
# Make sure mlx-lm is installed # pip install --upgrade mlx-lm # Generate text with mlx-lm from mlx_lm import load, generate model, tokenizer = load("pipenetwork/Qwen3.8-Flash-Next-MLX-6bit") prompt = "Write a story about Einstein" messages = [{"role": "user", "content": prompt}] prompt = tokenizer.apply_chat_template( messages, add_generation_prompt=True ) text = generate(model, tokenizer, prompt=prompt, verbose=True) - Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- LM Studio
- Pi
How to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit"
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": "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit 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 "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit"
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 pipenetwork/Qwen3.8-Flash-Next-MLX-6bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use pipenetwork/Qwen3.8-Flash-Next-MLX-6bit with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit"
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 "pipenetwork/Qwen3.8-Flash-Next-MLX-6bit" \ --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-6bit
MLX (Apple Silicon) build of Qwen3.8-Flash-Next — 125B-A6B hybrid Gated-DeltaNet / sparse-attention MoE with a 51B-parameter hashed n-gram embedding — quantized to 6-bit.
These files are modified: the weights are converted to MLX and quantized; the architecture is unchanged. The 4B multi-token-prediction head is not included. The vision tower is carried in bfloat16 but the runtime below is text-only.
Runtime
qwen4_exp is in no released mlx-lm (https://github.com/ml-explore/mlx-lm/pull/1788 is open and unmerged), so this repository ships its
own qwen4_exp.py and declares it via model_file:
pip install -U mlx-lm
mlx_lm.generate --model pipenetwork/Qwen3.8-Flash-Next-MLX-6bit --trust-remote-code \
--prompt "Write a Python function that merges overlapping intervals." --max-tokens 300
from mlx_lm import load, generate
model, tokenizer = load("pipenetwork/Qwen3.8-Flash-Next-MLX-6bit", trust_remote_code=True)
The bundled runtime is the open PR with three numerical fixes found while validating it against
transformers 5.16 (details and tests in https://github.com/PipeNetwork/qwen38-flash-next-mlx):
| what | reference | the PR as submitted | effect |
|---|---|---|---|
| RMSNorm variant | x/rms · (1 + w), zero-initialised |
x/rms · w |
half the channels of every residual read sign-flipped |
| n-gram hash seed | 1234 (transformers default; not in config.json) |
0 |
every bigram/trigram looks up an unrelated row |
| sparse-attention prefill | per-query blocks, own partial block visible, causal | global blocks; leaks future tokens, drops the query's own | wrong hidden states for prompts > 2048 tokens |
This checkpoint follows the mlx-lm convention for the norm fix: the +1 is folded into the stored
norm weights at conversion, and the runtime multiplies by w. Tiny-config parity against
transformers is 1e-7 on the dense path, exact on cached decode and chunked prefill.
Size and what is quantized
148.0 GB on disk (bfloat16 upstream: 360.0 GB).
| group | share of parameters | this build |
|---|---|---|
routed experts (switch_mlp) |
120.8B (96.6% of the 125B) | 6-bit, group 64 |
| n-gram embedding tables (128 shards × [2,500,012 × 160]) | 51.2B (separate) | 6-bit, group 32 |
attention, DeltaNet, hyper-connections, shared experts, embeddings, lm_head |
~4.2B | 6-bit, group 64 |
MoE router, shared_expert_gate, residual write gates, DeltaNet in_proj_a/b, indexer projection |
36M | bfloat16 |
| vision tower | 0.4B | bfloat16 (unused by this runtime) |
The n-gram tables need group size 32 because their row width (160) is not a multiple of 64; left in bfloat16 they alone would be 102 GB.
Quality
Perplexity on wikitext-2 (test), 296,815 tokens in 145 windows of 2048, every build scored on identical windows through this runtime. Perplexity varies far more between windows than between quants, so the comparison that means anything is paired: per-window NLL differences against bfloat16, bootstrapped over one shared index set (20,000 resamples).
| build | size | perplexity | ΔNLL/token vs bf16 [95% CI] | windows worse |
|---|---|---|---|---|
| bfloat16 (upstream) | 360.0 GB | 4.4708 | — | — |
| 8bit | 192.2 GB | 4.4749 | +0.0009 [−0.0003, +0.0021] | 73/145 |
| 6bit | 148.0 GB | 4.4767 | +0.0013 [−0.0003, +0.0029] | 81/145 |
| mixed-4_8bit | 106.2 GB | 4.5286 | +0.0128 [+0.0109, +0.0148] | 128/145 |
| 4bit | 103.8 GB | 5.3914 | +0.1872 [+0.1778, +0.1968] | 145/145 |
Read the interval, not the point estimate: an interval that straddles zero is a build that is statistically indistinguishable from bfloat16 on this corpus; "windows worse" counts how many of the 145 windows the build lost outright.
The mixed 4/8-bit build is the one to use at this size. Routed experts are 96.6% of the parameters, yet quantizing everything to 4-bit costs +20.6% while keeping only the ~3% of non-expert weights (attention, DeltaNet, hyper-connections, shared experts, embeddings) at 8-bit brings that to +1.3% for 2.4 GB more — the uniform 4-bit build is dominated and is published for completeness. 6-bit and 8-bit are statistically indistinguishable from bfloat16 on this corpus.
Where the 4-bit damage comes from
One group at a time moved back to 8-bit from the uniform 4-bit build, same windows, same runtime (the ablation builds are not published):
| everything 4-bit except… | perplexity | vs bfloat16 |
|---|---|---|
| — (uniform 4-bit) | 5.3914 | +20.6% |
hyper-connection read gates (input_mix_weight_down/up, 0.6B) at 8-bit |
4.9744 | +11.3% |
| attention, DeltaNet, shared experts, PLE projections (~2.3B) at 8-bit | 4.8969 | +9.5% |
embed_tokens and lm_head (1.3B) at 8-bit |
5.2843 | +18.2% |
| all three at 8-bit (= mixed-4_8bit) | 4.5286 | +1.3% |
No single group is responsible: the hyper-connection gates and the attention/DeltaNet projections each carry about half of the loss and the effects are roughly additive, so every non-expert weight is worth its 8 bits. Per parameter, these ~4B weights are roughly 20x more quantization-sensitive than the 121B of routed experts.
Greedy generation (a collapse detector, not a ranking) is coherent on every published build.
License
Qwen Community License 1.0, as the upstream model. Port code: https://github.com/PipeNetwork/qwen38-flash-next-mlx.
- Downloads last month
- -
6-bit
Model tree for pipenetwork/Qwen3.8-Flash-Next-MLX-6bit
Base model
Qwen/Qwen3.8-Flash-Next