Instructions to use mlx-community/VibeThinker-1.5B-mlx-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use mlx-community/VibeThinker-1.5B-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("mlx-community/VibeThinker-1.5B-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
- LM Studio
- Pi new
How to use mlx-community/VibeThinker-1.5B-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 "mlx-community/VibeThinker-1.5B-mlx-4bit"
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": "mlx-community/VibeThinker-1.5B-mlx-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use mlx-community/VibeThinker-1.5B-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 "mlx-community/VibeThinker-1.5B-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 mlx-community/VibeThinker-1.5B-mlx-4bit
Run Hermes
hermes
- MLX LM
How to use mlx-community/VibeThinker-1.5B-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 "mlx-community/VibeThinker-1.5B-mlx-4bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "mlx-community/VibeThinker-1.5B-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": "mlx-community/VibeThinker-1.5B-mlx-4bit", "messages": [ {"role": "user", "content": "Hello"} ] }'
VibeThinker-1.5B-mlx-4bit
This is a 4-bit quantized version of the VibeThinker-1.5B model, optimized for Apple Silicon using the MLX framework.
Model Details
- Original Model: WeiboAI/VibeThinker-1.5B
- Quantization: 4-bit
- Framework: MLX
Installation
To use this model, you need to install the mlx and mlx-lm packages:
pip install mlx mlx-lm
Usage
You can generate text using the mlx_lm.generate command:
mlx_lm.generate --model mlx-community/VibeThinker-1.5B-mlx-4bit --prompt "A café sells 6 types of drinks. A customer orders exactly 8 drinks (types may repeat), but no drink type may be chosen more than 3 times. How many distinct combinations of 8 drinks can the customer order? Give your answer as an integer." --temp 0.6 --top-p 0.95 --top-k -1 --max-tokens 40960
Or using Python:
from mlx_lm import load, generate
model, tokenizer = load("mlx-community/VibeThinker-1.5B-mlx-4bit")
response = generate(model, tokenizer, prompt="A café sells 6 types of drinks. A customer orders exactly 8 drinks (types may repeat), but no drink type may be chosen more than 3 times. How many distinct combinations of 8 drinks can the customer order? Give your answer as an integer.", verbose=True)
Original Model: VibeThinker-1.5B
🚨 We recommend using this model for competitive-style math and algorithm coding problems. It works better to ask the question in English. We do not advise using it for other tasks, as this is an experimental release aimed at exploring the reasoning capabilities of small models.
📁 Github | 🤖 Model Scope | 📄 Techical Report
Introduction
VibeThinker-1.5B is a 1.5-billion parameter dense language model. With a total training cost of only $7,800 USD, it achieves reasoning performance comparable to larger models like GPT OSS-20B Medium.
Key Performance Data
💡 Mathematical Reasoning: On the three major math benchmarks AIME24, AIME25, and HMMT25, its scores (80.3, 74.4, and 50.4, respectively) all surpass those of the initial DeepSeek R1 model, which has over 400 times the parameters (scores of 79.8, 70.0, and 41.7, respectively).
🌱 Code Generation: It achieved scores of 55.9 on LiveCodeBench v5 and 51.1 on v6. Its v6 score slightly leads Magistral Medium (50.3), underscoring its strong reasoning performance.
🔁 On the AIME 25 benchmark, VibeThinker-1.5B significantly extends the Pareto frontier of reasoning accuracy versus model scale, demonstrating that exceptional performance can be achieved with extreme parameter efficiency.
Training Pipeline
VibeThinker-1.5B's core innovation lies in the "Spectrum-to-Signal Principle" (SSP) training framework: it first explores solution diversity during the Supervised Fine-Tuning (SFT) stage, and then optimizes its policy to reinforce correct signals in the Reinforcement Learning (RL) stage. By systematically integrating these two phases, our approach establishes diversity as the central technical design principle, enabling VibeThinker-1.5B to achieve robust performance that surpasses conventional training paradigms.
- Downloads last month
- 181
4-bit



