Instructions to use Cactus-Compute/gemma-4-e2b-it-hybrid-mlx with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use Cactus-Compute/gemma-4-e2b-it-hybrid-mlx 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("Cactus-Compute/gemma-4-e2b-it-hybrid-mlx") 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 Cactus-Compute/gemma-4-e2b-it-hybrid-mlx with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx"
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": "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use Cactus-Compute/gemma-4-e2b-it-hybrid-mlx 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 "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx"
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 Cactus-Compute/gemma-4-e2b-it-hybrid-mlx
Run Hermes
hermes
- OpenClaw new
How to use Cactus-Compute/gemma-4-e2b-it-hybrid-mlx with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx"
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 "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx" \ --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"
- MLX LM
How to use Cactus-Compute/gemma-4-e2b-it-hybrid-mlx with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "Cactus-Compute/gemma-4-e2b-it-hybrid-mlx", "messages": [ {"role": "user", "content": "Hello"} ] }'
Configuration Parsing Warning:In config.json: "num_experts" must be a number
Cactus Hybrid — Gemma 4 E2B (MLX, 4-bit)
A small, on-device model is fast and private, but sometimes wrong. At Cactus we post-train models to know when they are wrong: we ship probes inside the checkpoint that score every answer with a confidence between 0 and 1, returned as structured data (never parsed out of the answer text). Answer on-device when confidence is high; re-route to a bigger model when it's low:
if confidence < 0.85:
answer = ask_a_bigger_model(prompt)
This repo holds the MLX-converted 4-bit build of
Cactus-Compute/gemma-4-e2b-it-hybrid.
The architecture ships in this repo via mlx-lm's model_file remote-code
mechanism (mlx-lm ≥ 0.30.1); the probe head is stored float32, never
quantized (only the trunk is 4-bit, g64).
Benchmarks
Gemma 4 E2B Hybrid, the smallest Gemma model, matches Gemini 3.1 Flash-Lite on most benchmarks by routing only 15–35% of queries to Flash-Lite and running the rest itself:
| Benchmark | Handoff to match Flash-Lite (FP16) | At 4-bit | At 3-bit |
|---|---|---|---|
| ChartQA | 15–20% | 25–30% | 40–50% |
| MMBench | 30–35% | 40–45% | 50–55% |
| LibriSpeech | 25–30% | 35–40% | 55–65% |
| GigaSpeech | 30–35% | 40–45% | 50–55% |
| MMAU | 30–35% | 35–40% | 50–55% |
| MMLU-Pro | 45–55% | ~90% | n/a |
Quantisation quality is measured on Cactus Quants, which performs well at uniform quantization; developers are encouraged to benchmark Unsloth, GGUF, and MLX quantization independently.
Quickstart
# pip install mlx-lm
import re
from mlx_lm import load, generate
model, tokenizer = load(
"Cactus-Compute/gemma-4-e2b-it-hybrid-mlx",
tokenizer_config={"trust_remote_code": True},
)
messages = [{"role": "user", "content": "What is the capital of France?"}]
answer = generate(
model,
tokenizer,
prompt=tokenizer.apply_chat_template(messages, add_generation_prompt=True),
max_tokens=512,
)
# the checkpoint reasons before answering; keep only the final answer
answer = re.split(r"<\|?channel\|?>", answer)[-1]
answer = re.sub(r"^(thought|final)\b\s*", "", answer).strip()
print(answer)
print("confidence:", model.last_confidence)
Confidence on MLX is exposed through the Python API — model.last_confidence
after generation (or model.confidence(num_tokens=N)). mlx_lm.server serves
the model fine but cannot add a confidence field to its responses, so read the
score in-process.
Calibration notes
- On matched generation trajectories the 4-bit probe drift vs the bf16 reference is under 0.01.
- The 4-bit trunk can shift the greedy thinking/non-thinking boundary versus bf16: some prompts enter the thinking channel where bf16 answers directly, and the probe legitimately scores those different generations lower. Easy vs hard ordering is fully preserved.
Routing quality (AUROC)
AUROC measures how well the probe separates wrong answers from right ones (higher = better, 0.5 is random, 1.0 is perfect):
| Hold-out | Modality | Cactus Hybrid | Token Entropy |
|---|---|---|---|
| MMLU | text MCQ | 0.770 | 0.697 |
| MMLU-Pro | text MCQ | 0.771 | 0.692 |
| ARC-Easy | text MCQ | 0.888 | 0.655 |
| ARC-Challenge | text MCQ | 0.834 | 0.646 |
| GSM8K (3-shot) | text gen | 0.782 | 0.731 |
| MMBench-EN-Dev | vision MCQ | 0.840 | 0.435 |
| ChartQA | vision QA | 0.779 | 0.615 |
| DocVQA | vision QA | 0.781 | 0.512 |
| MMAU | audio MCQ | 0.789 | 0.517 |
| GigaSpeech | audio | 0.876 | 0.343 |
| Earnings-22 | audio | 0.839 | 0.323 |
| LibriSpeech | audio | 0.822 | 0.427 |
| Mean | 0.814 | 0.549 |
The strongest result: the probe was trained on zero audio data, yet achieves 0.79–0.88 AUROC on four audio benchmarks (two transcription, one audio MCQ, one out-of-domain transcription). This rules out surface-level explanations: the probe is reading a modality-independent correctness signal from the hidden state, not memorizing patterns from training data.
All formats
All Cactus Hybrid builds live in the Cactus Hybrid collection: Transformers · GGUF / llama.cpp · MLX · Cactus engine. Copy-paste quickstarts for every engine: github.com/cactus-compute/cactus-hybrid.
License
Gemma is provided under and subject to the Gemma Terms of Use. This derivative includes the Cactus handoff probe head.
- Downloads last month
- 60
4-bit
Model tree for Cactus-Compute/gemma-4-e2b-it-hybrid-mlx
Base model
google/gemma-4-E2B