Instructions to use yugeshkarunamurthy/VibeThinker-3B-oQ6 with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use yugeshkarunamurthy/VibeThinker-3B-oQ6 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("yugeshkarunamurthy/VibeThinker-3B-oQ6") 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 yugeshkarunamurthy/VibeThinker-3B-oQ6 with Pi:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "yugeshkarunamurthy/VibeThinker-3B-oQ6"
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": "yugeshkarunamurthy/VibeThinker-3B-oQ6" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use yugeshkarunamurthy/VibeThinker-3B-oQ6 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 "yugeshkarunamurthy/VibeThinker-3B-oQ6"
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 yugeshkarunamurthy/VibeThinker-3B-oQ6
Run Hermes
hermes
- OpenClaw new
How to use yugeshkarunamurthy/VibeThinker-3B-oQ6 with OpenClaw:
Start the MLX server
# Install MLX LM: uv tool install mlx-lm # Start a local OpenAI-compatible server: mlx_lm.server --model "yugeshkarunamurthy/VibeThinker-3B-oQ6"
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 "yugeshkarunamurthy/VibeThinker-3B-oQ6" \ --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 yugeshkarunamurthy/VibeThinker-3B-oQ6 with MLX LM:
Generate or start a chat session
# Install MLX LM uv tool install mlx-lm # Interactive chat REPL mlx_lm.chat --model "yugeshkarunamurthy/VibeThinker-3B-oQ6"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "yugeshkarunamurthy/VibeThinker-3B-oQ6" # Calling the OpenAI-compatible server with curl curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "yugeshkarunamurthy/VibeThinker-3B-oQ6", "messages": [ {"role": "user", "content": "Hello"} ] }'
VibeThinker-3B-oQ6
oQ6 quantized version of VibeThinker-3B optimized for Apple Silicon.
This release provides a compact and efficient MLX conversion of VibeThinker-3B for local inference while preserving the strong reasoning, mathematics, and coding capabilities of the original model.
About VibeThinker-3B
VibeThinker-3B is a compact 3B parameter reasoning model developed by WeiboAI to explore the limits of verifiable reasoning in small language models.
Building upon the Spectrum-to-Signal (SSP) training methodology, VibeThinker-3B combines curriculum-based supervised fine-tuning, reinforcement learning, and self-distillation to achieve strong performance across:
- Mathematical reasoning
- Competitive programming
- Code generation
- STEM problem solving
- Instruction following
- Long-form reasoning
Despite its small size, VibeThinker-3B achieves performance competitive with significantly larger reasoning models on several challenging benchmarks. Its development focuses on maximizing reasoning efficiency rather than scaling parameter count alone.
Quantization
This release uses standard oQ quantization.
- Format: MLX
- Quantization: oQ6
- Group Size: 64
- Target Platform: Apple Silicon
This is not an oQ mixed-precision quantization. The model uses standard oQ6 quantization for efficient local deployment.
Recommended Settings
For best reasoning performance:
temp: 0.9
top_p: 0.95
rep_penalty: 1.05
presence_penalty: 1.5
enable_thinking: true
These settings encourage deeper reasoning chains while maintaining output diversity and stable long-form responses.
Example Usage
from mlx_lm import load, generate
model, tokenizer = load("VibeThinker-3B-oQ6")
prompt = """
Solve this problem step by step:
If a train travels 240 km in 3 hours,
what is its average speed?
"""
response = generate(
model,
tokenizer,
prompt=prompt,
temp=0.9,
top_p=0.95,
)
print(response)
Intended Use
This model is well suited for:
- Mathematical reasoning
- Programming assistance
- Algorithm design
- Competitive programming practice
- STEM education
- Research experiments
- Local reasoning agents
Hardware Recommendations
Recommended:
- Apple M1 Pro / Max
- Apple M2 Pro / Max / Ultra
- Apple M3 Series
- Apple M4 Series
Compatible with:
- MLX
- oMLX
- Open WebUI
- Custom agent frameworks
- Local Apple Silicon deployments
Credits
Original Model
All credit for the original model, training methodology, datasets, and research belongs to the WeiboAI team.
Original model:
WeiboAI/VibeThinker-3B
Quantized Release
This repository contains only an oQ6 quantized conversion of the original model for efficient Apple Silicon deployment.
Acknowledgements
- WeiboAI
- VibeThinker Research Team
- Apple MLX
- Hugging Face
References
VibeThinker-3B extends the Spectrum-to-Signal training paradigm and demonstrates that frontier-level reasoning capabilities can emerge in compact language models through optimized post-training rather than parameter scaling alone.
Citation
Please cite the original VibeThinker-3B paper when using this model in research.
@article{xu2026vibethinker3b,
title={VibeThinker-3B: Exploring the Frontier of Verifiable Reasoning in Small Language Models},
author={Sen Xu and Shixi Liu and Wei Wang and Jixin Min and Yingwei Dai and others},
year={2026},
eprint={2606.16140},
archivePrefix={arXiv},
primaryClass={cs.CL}
}
- Downloads last month
- 102
6-bit