Instructions to use SirSahOl/decider-2b-chat-mlx-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use SirSahOl/decider-2b-chat-mlx-4bit 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("SirSahOl/decider-2b-chat-mlx-4bit") 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 SirSahOl/decider-2b-chat-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 "SirSahOl/decider-2b-chat-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": "SirSahOl/decider-2b-chat-mlx-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use SirSahOl/decider-2b-chat-mlx-4bit with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "SirSahOl/decider-2b-chat-mlx-4bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "SirSahOl/decider-2b-chat-mlx-4bit" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "SirSahOl/decider-2b-chat-mlx-4bit", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use SirSahOl/decider-2b-chat-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 "SirSahOl/decider-2b-chat-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 SirSahOl/decider-2b-chat-mlx-4bit
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use SirSahOl/decider-2b-chat-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 "SirSahOl/decider-2b-chat-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 "SirSahOl/decider-2b-chat-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"
decider-2b-mlx-4bit
4-bit MLX conversion of JackFram/decider-2b optimized for Apple Silicon native GPU inference.
Converted by: SirSahOl
Source Model: JackFram/decider-2b
Framework: MLX by Apple
Quantization: 4-bit (Average 4.50 bits per weight)
Format: safetensors
License: unknown
Model Details
- Architecture: Qwen3_5ForCausalLM
- Parameters: 2.0B
- Context Length: 262,144 tokens
- Format: MLX (Apple Silicon native GPU format)
- Quantization: 4-bit (Average 4.50 bits per weight)
- Active VRAM Footprint: ~1.5 GB (Minimum recommended: 8 GB Unified Memory)
Quick Start
Installation
pip install mlx-lm
Usage
CLI
# Chat interactively
mlx_lm.chat --model SirSahOl/decider-2b-chat-mlx-4bit
# Generate text
mlx_lm.generate --model SirSahOl/decider-2b-chat-mlx-4bit --prompt "Write a short poem about artificial intelligence."
Python API (with Chat Template)
from mlx_lm import load, generate
model, tokenizer = load("SirSahOl/decider-2b-chat-mlx-4bit")
messages = [
{"role": "user", "content": "Explain quantum superposition in simple terms."}
]
prompt = tokenizer.apply_chat_template(
messages, tokenize=False, add_generation_prompt=True
)
response = generate(model, tokenizer, prompt=prompt, verbose=True)
print(response)
Performance Benchmarks
Apple Silicon Hardware Sizing Matrix
Estimated decoding throughput, time-to-first-token (TTFT), and active unified memory footprint across Apple Silicon tiers:
| Apple Silicon Tier | Unified Memory | Active VRAM | Estimated Speed | Est. TTFT | Recommended Use Case |
|---|---|---|---|---|---|
| M1 / M2 / M3 / M4 (Base) | 8 GB Unified Memory | ~1.5 GB | ~102 tokens/sec | ~31 ms | Everyday interactive assistant & fast local completions |
| M1 / M2 / M3 / M4 Pro | 18 GB – 36 GB | ~1.5 GB | ~153 tokens/sec | ~21 ms | Balanced daily driver for coding, tool invocation, and multi-turn chat |
| M1 / M2 / M3 / M4 Max | 36 GB – 128 GB | ~1.5 GB | ~219 tokens/sec | ~13 ms | High-throughput generation, low latency, agent orchestration |
| M1 / M2 / M3 Ultra | 64 GB – 192 GB | ~1.5 GB | ~306 tokens/sec | ~9 ms | Peak concurrency, batch document extraction, production serving |
Projections based on Apple Silicon memory bandwidth saturation for 4-bit weights. Real-world speeds vary by prompt length.
Multi-Quantization Comparison
Evaluate your hardware budget and choose the optimal precision:
| Variant | Disk Size | VRAM Footprint | Target Apple Silicon Hardware | Key Advantage |
|---|---|---|---|---|
| 4-bit MLX (This Repository) | ~1.5 GB | ~1.5 GB | M1 / M2 / M3 / M4 (8GB+) | Maximum generation speed and lowest RAM overhead. |
| 8-bit MLX | ~2.6 GB | ~2.6 GB | M1 / M2 / M3 / M4 Pro/Max (16GB+) | Balanced accuracy and generation speed; near-lossless reasoning. |
| 16-bit MLX | ~4.8 GB | ~4.8 GB | M2 / M3 / M4 Max/Ultra (32GB+) | Full unquantized precision; reference evaluation quality. |
Who Should Use This?
| Your Hardware | Recommended Quantization |
|---|---|
| M1/M2/M3/M4 (8GB – 16GB) | 4-bit — Best balance of speed, low memory, and multitasking capability |
| M1/M2/M3/M4 Pro/Max (18GB – 36GB) | 8-bit — Higher quality reasoning with comfortable memory headroom |
| M1/M2/M3/M4 Max/Ultra (36GB – 192GB) | 16-bit — Unquantized full precision, zero quality degradation |
General guidance:
- Use 4-bit if you want to run this model alongside IDEs, browsers, and background development tools.
- Use 8-bit if you have 16GB+ unified memory and require superior reasoning and code accuracy.
- Use 16-bit for research, benchmarking, evaluation, or high-end workstation deployments.
Other Quantization Variants
| Variant | Link |
|---|---|
| 4-bit | SirSahOl/decider-2b-chat-mlx-4bit |
| 8-bit | SirSahOl/decider-2b-chat-mlx-8bit |
| 16-bit | SirSahOl/decider-2b-chat-mlx-16bit |
LM Studio & Local Inference Setup Guide
To prevent runaway loops and ensure correct conversational turn-taking, configure custom stop tokens in your local inference runtime:
<|im_start|><|im_end|><|endoftext|>
Prompt Template Formatting
- System Prefix:
<|im_start|>system\n - System Suffix:
<|im_end|>\n - User Prefix:
<|im_start|>user\n - Assistant Suffix:
<|im_end|>\n<|im_start|>assistant\n
Ollama Quickstart
FROM SirSahOl/decider-2b-chat-mlx-4bit
PARAMETER stop "<|im_start|>"
PARAMETER stop "<|im_end|>"
PARAMETER stop "<|endoftext|>"
PARAMETER temperature 0.7
ollama create decider-2b-chat-mlx-4bit -f Modelfile
ollama run decider-2b-chat-mlx-4bit
Conversion Details
| Property | Value |
|---|---|
| Source Model | JackFram/decider-2b |
| Quantization | 4-bit |
| mlx-lm Version | 0.31.3 |
| Conversion Time | 6.2s |
| Output Size | 1.0 GB |
| Date | 2026-09-22T02:29:01.753970+00:00 |
Reproduction
To reproduce this conversion:
pip install mlx-lm==0.31.3
python3 -m mlx_lm.convert --hf-path /root/.cache/huggingface/hub/models--Mapika--decider-2b/snapshots/b37f7e1ba3fbc9238004cf531fabbee2619973fd --mlx-path output/decider-2b-mlx-4bit -q --q-bits 4
Limitations & Known Issues
- 4-bit group-wise quantization introduces minor precision loss compared to unquantized weights; for deep mathematical derivations or precision-critical reasoning, test the 8-bit or 16-bit variants.
- High context sequences (>32K tokens) require sufficient unified memory headroom; ensure unified memory is not overcommitted.
- This is a weight-only MLX conversion designed specifically for Apple Silicon GPUs (M1/M2/M3/M4 series).
License
This model conversion inherits the license of the source model: unknown.
See the original model card for full license details.
Changelog
| Version | Date | Changes |
|---|---|---|
| v1.0 | 2026-09-22 | Initial conversion |
Converted with MLX Foundry — a professional pipeline for converting models to Apple MLX format.
- Downloads last month
- 42
4-bit