Text Generation
MLX
Safetensors
Mixture of Experts
edge-inference
prerouter
lora
ssd-offload
multi-platform
ios
android
windows
macos
conversational
custom_code
4-bit precision
Instructions to use Edge0/Edge0-8B-A1B-preview with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use Edge0/Edge0-8B-A1B-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-8B-A1B-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-8B-A1B-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-8B-A1B-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-8B-A1B-preview" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use Edge0/Edge0-8B-A1B-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-8B-A1B-preview"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "Edge0/Edge0-8B-A1B-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-8B-A1B-preview", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use Edge0/Edge0-8B-A1B-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-8B-A1B-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-8B-A1B-preview
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use Edge0/Edge0-8B-A1B-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-8B-A1B-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-8B-A1B-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
Browse files
README.md
CHANGED
|
@@ -7,6 +7,11 @@ tags:
|
|
| 7 |
- prerouter
|
| 8 |
- lora
|
| 9 |
- ssd-offload
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 10 |
base_model:
|
| 11 |
- inclusionAI/Ling-3.0-tiny-base
|
| 12 |
pipeline_tag: text-generation
|
|
@@ -22,6 +27,8 @@ pipeline_tag: text-generation
|
|
| 22 |
|
| 23 |
**1 GiB active memory · 25 tok/s · 4-bit**
|
| 24 |
|
|
|
|
|
|
|
| 25 |
[](https://github.com/Edge0-AI/edge0)
|
| 26 |
[](https://huggingface.co/Edge0/Edge0-35b-a3b-preview)
|
| 27 |
[](https://huggingface.co/Edge0/Edge0-8b-a1b-preview)
|
|
@@ -30,6 +37,11 @@ pipeline_tag: text-generation
|
|
| 30 |
[](https://arxiv.org/abs/2609.18063)
|
| 31 |
[](https://github.com/Edge0-AI/edge0/blob/main/LICENSE)
|
| 32 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 33 |
</div>
|
| 34 |
|
| 35 |
|
|
@@ -53,8 +65,36 @@ via the [edge0](https://github.com/Edge0-AI/edge0) streaming inference framework
|
|
| 53 |
|
| 54 |
</div>
|
| 55 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 56 |
## Highlights
|
| 57 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 58 |
- **Runs in phone-class memory**: the full 4-bit checkpoint stays on
|
| 59 |
storage and experts are streamed on demand, so only the active
|
| 60 |
weights are in RAM — under **1 GiB**, with no sharding and no
|
|
@@ -143,8 +183,10 @@ Measured with `examples/bench.py` on a Mac mini M4 Pro, 24 GB:
|
|
| 143 |
agentic tasks — tool use, multi-step planning, and long-horizon
|
| 144 |
autonomy are currently weak. The full release will substantially
|
| 145 |
strengthen agent capability.
|
| 146 |
-
-
|
| 147 |
-
on
|
|
|
|
|
|
|
| 148 |
|
| 149 |
## Quick start
|
| 150 |
|
|
|
|
| 7 |
- prerouter
|
| 8 |
- lora
|
| 9 |
- ssd-offload
|
| 10 |
+
- multi-platform
|
| 11 |
+
- ios
|
| 12 |
+
- android
|
| 13 |
+
- windows
|
| 14 |
+
- macos
|
| 15 |
base_model:
|
| 16 |
- inclusionAI/Ling-3.0-tiny-base
|
| 17 |
pipeline_tag: text-generation
|
|
|
|
| 27 |
|
| 28 |
**1 GiB active memory · 25 tok/s · 4-bit**
|
| 29 |
|
| 30 |
+
**Native engines on iOS · macOS · Android · Windows.**
|
| 31 |
+
|
| 32 |
[](https://github.com/Edge0-AI/edge0)
|
| 33 |
[](https://huggingface.co/Edge0/Edge0-35b-a3b-preview)
|
| 34 |
[](https://huggingface.co/Edge0/Edge0-8b-a1b-preview)
|
|
|
|
| 37 |
[](https://arxiv.org/abs/2609.18063)
|
| 38 |
[](https://github.com/Edge0-AI/edge0/blob/main/LICENSE)
|
| 39 |
|
| 40 |
+
[](https://github.com/Edge0-AI/edge0/tree/main/ios)
|
| 41 |
+
[](https://github.com/Edge0-AI/edge0/tree/main/macos)
|
| 42 |
+
[](https://github.com/Edge0-AI/edge0/tree/main/android)
|
| 43 |
+
[](https://github.com/Edge0-AI/edge0/tree/main/windows)
|
| 44 |
+
|
| 45 |
</div>
|
| 46 |
|
| 47 |
|
|
|
|
| 65 |
|
| 66 |
</div>
|
| 67 |
|
| 68 |
+
## Platforms — one model, four native engines
|
| 69 |
+
|
| 70 |
+
<div align="center">
|
| 71 |
+
|
| 72 |
+
**On 2026-09-30 we released the edge0 inference engines for
|
| 73 |
+
four platforms — so users get the best inference experience across
|
| 74 |
+
architectures and platforms. The source is open-sourced in the
|
| 75 |
+
[edge0 repo](https://github.com/Edge0-AI/edge0).**
|
| 76 |
+
|
| 77 |
+
| Platform | Native engine (open source) |
|
| 78 |
+
|---|---|
|
| 79 |
+
| 📱 **iOS** | [edge0/ios](https://github.com/Edge0-AI/edge0/tree/main/ios) |
|
| 80 |
+
| 🖥️ **macOS** | [edge0/macos](https://github.com/Edge0-AI/edge0/tree/main/macos) |
|
| 81 |
+
| 🤖 **Android** | [edge0/android](https://github.com/Edge0-AI/edge0/tree/main/android) |
|
| 82 |
+
| 🪟 **Windows** | [edge0/windows](https://github.com/Edge0-AI/edge0/tree/main/windows) |
|
| 83 |
+
|
| 84 |
+
</div>
|
| 85 |
+
|
| 86 |
+
This checkpoint is built for all of them: one model directory — the same
|
| 87 |
+
int4 base plus LoRA / prerouter adapters — runs unchanged on every
|
| 88 |
+
platform, so what you download here is what ships on a phone, a desktop
|
| 89 |
+
and a laptop alike.
|
| 90 |
+
|
| 91 |
## Highlights
|
| 92 |
|
| 93 |
+
- **Runs on iOS, macOS, Android and Windows**: the edge0 inference
|
| 94 |
+
engines are **open-source and native on all four platforms** — one
|
| 95 |
+
model, the best inference experience on every architecture and
|
| 96 |
+
platform (see [Platforms](#platforms--one-model-four-native-engines)
|
| 97 |
+
below).
|
| 98 |
- **Runs in phone-class memory**: the full 4-bit checkpoint stays on
|
| 99 |
storage and experts are streamed on demand, so only the active
|
| 100 |
weights are in RAM — under **1 GiB**, with no sharding and no
|
|
|
|
| 183 |
agentic tasks — tool use, multi-step planning, and long-horizon
|
| 184 |
autonomy are currently weak. The full release will substantially
|
| 185 |
strengthen agent capability.
|
| 186 |
+
- Platform coverage: the performance numbers above are measured with
|
| 187 |
+
the MLX backend on Apple Silicon; engine coverage and tuning on the
|
| 188 |
+
iOS / Android / Windows engines are still maturing (see
|
| 189 |
+
[Platforms](#platforms--one-model-four-native-engines)).
|
| 190 |
|
| 191 |
## Quick start
|
| 192 |
|