Text Generation
MLX
Safetensors
English
maple
causal-lm
mixture-of-experts
reasoning
custom-code
quantized
oq4e
conversational
4-bit precision
Instructions to use txgsync/Maple-Preview-oQ4e with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use txgsync/Maple-Preview-oQ4e 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("txgsync/Maple-Preview-oQ4e") 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 txgsync/Maple-Preview-oQ4e with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "txgsync/Maple-Preview-oQ4e"
Configure the model in Pi
# Install Pi: npm install -g @mariozechner/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "mlx-lm": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "txgsync/Maple-Preview-oQ4e" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use txgsync/Maple-Preview-oQ4e with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "txgsync/Maple-Preview-oQ4e"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "txgsync/Maple-Preview-oQ4e" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "txgsync/Maple-Preview-oQ4e", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use txgsync/Maple-Preview-oQ4e 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 "txgsync/Maple-Preview-oQ4e"
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 txgsync/Maple-Preview-oQ4e
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use txgsync/Maple-Preview-oQ4e with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "txgsync/Maple-Preview-oQ4e"
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 "txgsync/Maple-Preview-oQ4e" \ --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"
Add verified Maple oQ4e model card
Browse files
README.md
ADDED
|
@@ -0,0 +1,75 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: mit
|
| 3 |
+
language: en
|
| 4 |
+
library_name: mlx
|
| 5 |
+
pipeline_tag: text-generation
|
| 6 |
+
base_model: deepgrove/maple-preview
|
| 7 |
+
base_model_relation: quantized
|
| 8 |
+
tags:
|
| 9 |
+
- mlx
|
| 10 |
+
- causal-lm
|
| 11 |
+
- mixture-of-experts
|
| 12 |
+
- reasoning
|
| 13 |
+
- custom-code
|
| 14 |
+
- quantized
|
| 15 |
+
- oq4e
|
| 16 |
+
---
|
| 17 |
+
|
| 18 |
+
# Maple Preview — oQ4e MLX quantization
|
| 19 |
+
|
| 20 |
+
This repository contains an enhanced mixed-precision oQ4e MLX quantization of [`deepgrove/maple-preview`](https://huggingface.co/deepgrove/maple-preview), converted from the BF16 safetensors with oMLX.
|
| 21 |
+
|
| 22 |
+
## This MLX quant upload
|
| 23 |
+
|
| 24 |
+
- Approximately 11.8 GB for the complete local model directory (11,786,973,625 bytes).
|
| 25 |
+
- Uses the same 1,024-sample, 512-token enhanced iMatrix calibration as the oQ8e conversion.
|
| 26 |
+
- 18,432 ordinary tensors are 4-bit, with sensitivity-selected 5-, 6-, and 8-bit upgrades; no quantized tensor is below 4-bit.
|
| 27 |
+
- The 24 MoE router matrices and all normalization weights remain BF16.
|
| 28 |
+
- `lm_head` and `model.word_embeddings` are 8-bit.
|
| 29 |
+
- Maple's fused Q/K/V projections use shape-compatible per-layer formats and have been runtime-tested through oMLX.
|
| 30 |
+
- Requires custom-code loading (`trust_remote_code=True`). In oMLX, enable **Trust Remote Code** for this model.
|
| 31 |
+
|
| 32 |
+
This is an MLX conversion for local inference on Apple Silicon. Please follow the base model's MIT license and usage terms.
|
| 33 |
+
|
| 34 |
+
---
|
| 35 |
+
|
| 36 |
+
## Base model description
|
| 37 |
+
|
| 38 |
+
# Maple-Preview
|
| 39 |
+
|
| 40 |
+
**DeepGrove · 2026**
|
| 41 |
+
|
| 42 |
+
Today we introduce Maple-Preview, an open-source 20B-A1B ternary-weight reasoning LLM. Maple-Preview has SOTA reasoning for its weight class and is even competitive with larger models. It solves IMO-level problems and runs at 200+ tokens/sec on a Mac mini M4, 5–16× faster than efficient models like Gemma 4, Qwen3.5, and gpt-oss.
|
| 43 |
+
|
| 44 |
+
- 20B-A1B Model
|
| 45 |
+
- 218 tok/s M4 Mac mini
|
| 46 |
+
- 5.31 GB Checkpoint
|
| 47 |
+
- 131,072 Token context
|
| 48 |
+
|
| 49 |
+

|
| 50 |
+
|
| 51 |
+
> [!NOTE]
|
| 52 |
+
> The included Transformers implementation depends on Triton and FlashAttention
|
| 53 |
+
> and is intended for a compatible CUDA environment. The reported Apple Silicon
|
| 54 |
+
> result uses a separate on-device runtime.
|
| 55 |
+
|
| 56 |
+
## Architecture
|
| 57 |
+
|
| 58 |
+
Maple-Preview is a 20B-A1B reasoning model designed from the start for efficient on-device inference. It utilizes a 24-layer, 256-expert (8 active) configuration with 3:1 SWA-512:GA attention.
|
| 59 |
+
|
| 60 |
+
## Evaluation
|
| 61 |
+
|
| 62 |
+
On benchmarks, Maple-Preview sets a new point on the Pareto frontier for both memory-to-performance and speed-to-performance, demonstrating its strong reasoning capabilities. However, we note that this preview is focused primarily on raw reasoning and, as such, may underperform on agentic benchmarks. We intend to continue improving general performance through extended training before Maple's full release.
|
| 63 |
+
|
| 64 |
+

|
| 65 |
+
|
| 66 |
+
Capability comparison using the dense output head across LCBv6, AIME 2026, HMMT 2026, and GPQA-D.
|
| 67 |
+
|
| 68 |
+
## Limitations
|
| 69 |
+
|
| 70 |
+
This preview received minimal post-training for agentic tasks and only
|
| 71 |
+
small-scale general reinforcement learning.
|
| 72 |
+
|
| 73 |
+
## License
|
| 74 |
+
|
| 75 |
+
Maple-Preview is released under the [MIT License](LICENSE).
|