Instructions to use tablinum/Moon-Beam-8B-A1B-MLX-Preview with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use tablinum/Moon-Beam-8B-A1B-MLX-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("tablinum/Moon-Beam-8B-A1B-MLX-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 tablinum/Moon-Beam-8B-A1B-MLX-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 "tablinum/Moon-Beam-8B-A1B-MLX-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": "tablinum/Moon-Beam-8B-A1B-MLX-Preview" } ] } } }Run Pi
# Start Pi in your project directory: pi
- MLX LM
How to use tablinum/Moon-Beam-8B-A1B-MLX-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 "tablinum/Moon-Beam-8B-A1B-MLX-Preview"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "tablinum/Moon-Beam-8B-A1B-MLX-Preview" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "tablinum/Moon-Beam-8B-A1B-MLX-Preview", "messages": [ {"role": "user", "content": "Hello"} ] }' - Hermes Agent
How to use tablinum/Moon-Beam-8B-A1B-MLX-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 "tablinum/Moon-Beam-8B-A1B-MLX-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 tablinum/Moon-Beam-8B-A1B-MLX-Preview
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use tablinum/Moon-Beam-8B-A1B-MLX-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 "tablinum/Moon-Beam-8B-A1B-MLX-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 "tablinum/Moon-Beam-8B-A1B-MLX-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"
Moon-beam 8B A1B · MLX · preview
Moon-beam is a mixture-of-experts model with 8B total parameters, about 1B active per token, and a 131,072-token context window. It pairs inclusionAI’s Ling-3.0-tiny with Tablinum’s searchable knowledge library, the engram. Round 1b was fine-tuned with QLoRA on retrieved passages, math problems, tool calls, and multi-turn conversations. Model and evaluation notes
On the model-card protocol evaluation (temperature 1.0, top_p 0.95, top_k 20, up to 32K new tokens, the full 131K window), Moon-beam scored 95.5% on 400 GSM8K questions with thinking on. On EngramBench it answered 436 of 503 questions correctly (86.5%) with thinking on and passages from each question’s own table. As a support agent on tau2-bench it earned an average reward of 0.71 on airline and 0.80 on retail conversations.
Preview. These weights are the release candidate (round 1b). They run today with the Tablinum-2 library. Tablinum-3, about twice the library, is still being built and tested; when it is, these cards and the engram pack will be updated and the
-Previewsuffix dropped. Numbers marked preliminary are being re-measured with the model-card protocol (temperature 1.0, top_p 0.95, top_k 20, up to 32K new tokens, full 131K window).
Run it (Apple Silicon)
pip install -U "mlx-lm>=0.32"
mlx_lm.generate --model tablinum/Moon-Beam-8B-A1B-MLX-Preview --prompt "What is 17 * 23?" --max-tokens 2048 --temp 1.0 --top-p 0.95 --top-k 20
mlx_lm.server --model tablinum/Moon-Beam-8B-A1B-MLX-Preview --port 8000 # OpenAI-style API
Add the library. Moon-beam is trained to answer from retrieved passages. Put terrabeam in front of your server and every request gets them, in the exact layout the model was trained on:
terrabeam proxy --upstream http://127.0.0.1:8000 --format tablinum --memory long-term # then use http://127.0.0.1:8090/v1
4-bit experts with 8-bit attention and shared weights ("beam" mix), 4.6 GB. Top-1 agreement with BF16: 96.75% on mixed chat, code and math, 90.92% on WikiText (KLD 0.0115 / 0.0444). Converted with mlx-lm 0.32 and smoke-tested on CPU (MLX).
Other formats: MLX 8-bit · GGUF · BF16
How much does retrieval help?
With thinking on, retrieved passages raised SimpleQA from 30 to 601 correct answers out of 1,000. The same comparison on EngramBench went from 61 to 436 correct out of 503. Answers are graded blind with AA-Omniscience’s grader template — a deterministic rule pass first, then an LLM judge — with partial answers and abstentions counted separately from correct answers.
Read the figures as text
| Test (questions) | Thinking on · closed → retrieved | Thinking off · closed → retrieved |
|---|---|---|
| EngramBench (503) | 12.1% → 86.5% | 8.5% → 87.9% |
| SimpleQA (1000) | 3.0% → 60.1% | 3.0% → 58.1% |
| AA-Omniscience (200) | 10.5% → 28.0% | 7.5% → 27.0% |
The untrained Ling base also reached 59.2% on SimpleQA with the same passages and thinking on, compared with 60.1% for round 1b on the card protocol. The base used IQ3 and earlier settings. The clearest gain in these runs comes from giving the model relevant passages. Graded counts and settings — the numbers above are the re-measured card-protocol runs; the November 4 file keeps the preliminary graded counts for comparison.
Reasoning and follow-ups
Across 150 question pairs, Moon-beam answered 94.0% of first questions and 93.3% of second questions correctly in the same conversation with thinking on.
Read the figures as text
| Test · sample size | Thinking on | Thinking off |
|---|---|---|
| GSM8K · 400 | 96.2% | 92.5% |
| Multi-turn, first · 150 | 94.0% | 86.7% |
| Multi-turn, second · 150 | 93.3% | 88.7% |
| MMLU-Pro · 700 | 63.9% | 44.0% |
The thinking-off column used greedy decoding. On MMLU-Pro, 70 of 700 thinking-on answers reached the 30,000-token output cap. The sampled base also scored 96.2% on GSM8K. The release evaluation uses revised sampling and a 32K output allowance. Preliminary results and protocol
Talking a customer through a fix
On tau2-bench — multi-turn support conversations where Moon-beam is the agent, a Claude Haiku customer calls with a problem, and database and environment checks decide success — Moon-beam earned an average reward of 0.71 on 50 airline tasks and 0.80 on 114 retail tasks, with thinking on. The earlier as-shipped harness capped each turn and dropped the model's reasoning between steps, scoring 0.05 and 0.22 on the same domains; carrying the reasoning forward, in the layout Moon-beam was trained on, is what changed. Telecom and banking are being measured the same way.
| tau2 domain · tasks | Corrected protocol | As-shipped harness |
|---|---|---|
| Airline · 50 | 0.711 | 0.045 |
| Retail · 114 | 0.797 | 0.217 |
| Telecom · 114 | in progress | 0.000 |
| Banking | in progress | — |
How small can the model file be?
Q4_K_M fits in a 4.94 GB file, 68.7% smaller than the BF16 GGUF. On 8,393 mixed chat, code, and math positions, it selected the same top token as BF16 97.65% of the time. On WikiText, agreement was 92.74%.
Read the figures as text
| Build | File size | Mixed top-1 match | WikiText top-1 match |
|---|---|---|---|
| Q4_K_M | 4.94 GB | 97.65% | 92.74% |
| Q6_K | 7.23 GB | 98.92% | 96.74% |
| Q8_0 | 8.41 GB | 99.18% | 97.20% |
| MLX beam | 4.92 GB | 96.75% | 90.92% |
| MLX 8-bit | 8.87 GB | 99.20% | 97.40% |
MLX beam uses 4-bit experts and 8-bit weights elsewhere. The MLX sizes above use the posted shard bytes in decimal GB. They correspond to 4.58 and 8.26 GiB, respectively. The full ladder includes all eleven GGUF and MLX measurements, with KL divergence and perplexity for both token sets. Quantization measurements · GGUF file sizes
Decode speed on a 12 GB GPU
On an RTX A2000 12 GB, the Q4_K_M model averaged 154.6 output tokens/s with the MTP draft head, up from 136.9 tokens/s alone. That is a 12.9% higher mean across three prompts with thinking off and greedy decoding. Two prompts sped up. The second slowed from 136.9 to 131.7 tokens/s.
Read the figures as text
| Prompt | Trunk alone (tokens/s) | MTP n=2 (tokens/s) |
|---|---|---|
| 1 | 137.3 | 176.5 |
| 2 | 136.9 | 131.7 |
| 3 | 136.6 | 155.7 |
The draft head is a separate 0.55 GB file. These measurements use a maximum of two draft tokens per step. Raw timings
Thanksgiving artwork
Moon-pie Rescue follows the Moon-beam cat as it catches a drifting pumpkin pie and offers you a slice. Open the 12-second MP4 · View the still banner
Small paws. Big thanks.
Model family
BF16 · GGUF · FP8 · MLX mixed-bit · MLX 8-bit
Credit and license
MIT, like the Ling-3.0-tiny base. Keep the notice; if Moon-beam or the Tablinum research helps you, a mention or a thank-you is appreciated. Library tables keep their own licenses: Tablinum-2. Runner: terrabeam (MIT).
- Downloads last month
- 384
4-bit
Model tree for tablinum/Moon-Beam-8B-A1B-MLX-Preview
Base model
inclusionAI/Ling-3.0-tiny



