Text Generation
MLX
Safetensors
qwen3_5_moe
Mixture of Experts
edge-inference
prerouter
lora
ssd-offload
multi-platform
ios
android
windows
macos
conversational
4-bit precision
Instructions to use Edge0/Edge0-35B-A3B-preview with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use Edge0/Edge0-35B-A3B-preview 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("Edge0/Edge0-35B-A3B-preview") 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 Edge0/Edge0-35B-A3B-preview with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "Edge0/Edge0-35B-A3B-preview"
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": "Edge0/Edge0-35B-A3B-preview" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use Edge0/Edge0-35B-A3B-preview with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "Edge0/Edge0-35B-A3B-preview"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "Edge0/Edge0-35B-A3B-preview" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Edge0/Edge0-35B-A3B-preview", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use Edge0/Edge0-35B-A3B-preview 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 "Edge0/Edge0-35B-A3B-preview"
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 Edge0/Edge0-35B-A3B-preview
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Edge0/Edge0-35B-A3B-preview with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "Edge0/Edge0-35B-A3B-preview"
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 "Edge0/Edge0-35B-A3B-preview" \ --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"
Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -33,6 +33,24 @@ pipeline_tag: text-generation
|
|
| 33 |
**Edge0-35b-a3b** — a 35B MoE LLM that runs at viable speed on portable devices in under **2.9 GiB of active memory** (1/8 of its 23 GB weight footprint),
|
| 34 |
via the [edge0](https://github.com/Edge0-AI/edge0) streaming inference framework.
|
| 35 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 36 |
Three mechanisms make this work:
|
| 37 |
|
| 38 |
- **SSD expert offload**: expert weights are streamed from storage on
|
|
@@ -48,10 +66,6 @@ Three mechanisms make this work:
|
|
| 48 |
quantization loss at 4-bit (see Quality below). Adapters stay
|
| 49 |
unmerged: one read-only base serves multiple adapter sets.
|
| 50 |
|
| 51 |
-
> **Preview status:** this is an early preview release of the edge0
|
| 52 |
-
> pipeline. The checkpoint ships as int4 quantization plus LoRA and
|
| 53 |
-
> prerouter adapters trained for this framework.
|
| 54 |
-
|
| 55 |
## Model summary
|
| 56 |
|
| 57 |
| | |
|
|
@@ -96,19 +110,6 @@ Measured with `examples/bench.py` on a Mac mini M4 Pro, 24 GB:
|
|
| 96 |
*Short contexts; long contexts add KV cache. Expert weights stream from
|
| 97 |
SSD on demand and are not resident.
|
| 98 |
|
| 99 |
-
## Highlights
|
| 100 |
-
|
| 101 |
-
- **Runs in phone-class memory**: the full 4-bit checkpoint stays on
|
| 102 |
-
storage and experts are streamed on demand, so only the active
|
| 103 |
-
weights are in RAM — under **2.9 GiB**, with no sharding and no
|
| 104 |
-
upfront download of the weights into memory.
|
| 105 |
-
- **Fast enough for interactive use**: 14.9–17.7 tok/s decode on a
|
| 106 |
-
Mac mini M4 Pro; long prompts fill in at 113–140 tok/s.
|
| 107 |
-
- **Quality kept after quantization**: Recover-LoRA distillation keeps
|
| 108 |
-
the int4 model within **3.9 points** of its fp16 base.
|
| 109 |
-
- **Works out of the box**: base, LoRA and prerouter adapters ship
|
| 110 |
-
together and load automatically via `edge0`.
|
| 111 |
-
|
| 112 |
## Use cases
|
| 113 |
|
| 114 |
- Edge / on-device inference where GPU VRAM is scarce and storage is
|
|
|
|
| 33 |
**Edge0-35b-a3b** — a 35B MoE LLM that runs at viable speed on portable devices in under **2.9 GiB of active memory** (1/8 of its 23 GB weight footprint),
|
| 34 |
via the [edge0](https://github.com/Edge0-AI/edge0) streaming inference framework.
|
| 35 |
|
| 36 |
+
> **Preview status:** this is an early preview release of the edge0
|
| 37 |
+
> pipeline. The checkpoint ships as int4 quantization plus LoRA and
|
| 38 |
+
> prerouter adapters trained for this framework.
|
| 39 |
+
|
| 40 |
+
## Highlights
|
| 41 |
+
|
| 42 |
+
- **Runs in phone-class memory**: the full 4-bit checkpoint stays on
|
| 43 |
+
storage and experts are streamed on demand, so only the active
|
| 44 |
+
weights are in RAM — under **2.9 GiB**, with no sharding and no
|
| 45 |
+
upfront download of the weights into memory.
|
| 46 |
+
- **Fast enough for interactive use**: 14.9–17.7 tok/s decode on a
|
| 47 |
+
Mac mini M4 Pro; long prompts fill in at 113–140 tok/s.
|
| 48 |
+
- **Quality kept after quantization**: Recover-LoRA distillation keeps
|
| 49 |
+
the int4 model within **3.9 points** of its fp16 base.
|
| 50 |
+
- **Works out of the box**: base, LoRA and prerouter adapters ship
|
| 51 |
+
together and load automatically via `edge0`.
|
| 52 |
+
|
| 53 |
+
|
| 54 |
Three mechanisms make this work:
|
| 55 |
|
| 56 |
- **SSD expert offload**: expert weights are streamed from storage on
|
|
|
|
| 66 |
quantization loss at 4-bit (see Quality below). Adapters stay
|
| 67 |
unmerged: one read-only base serves multiple adapter sets.
|
| 68 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 69 |
## Model summary
|
| 70 |
|
| 71 |
| | |
|
|
|
|
| 110 |
*Short contexts; long contexts add KV cache. Expert weights stream from
|
| 111 |
SSD on demand and are not resident.
|
| 112 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 113 |
## Use cases
|
| 114 |
|
| 115 |
- Edge / on-device inference where GPU VRAM is scarce and storage is
|