Instructions to use majentik/gpt-oss-120b-RotorQuant-MLX-4bit with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- MLX
How to use majentik/gpt-oss-120b-RotorQuant-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("majentik/gpt-oss-120b-RotorQuant-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 majentik/gpt-oss-120b-RotorQuant-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 "majentik/gpt-oss-120b-RotorQuant-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": "majentik/gpt-oss-120b-RotorQuant-MLX-4bit" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Hermes Agent new
How to use majentik/gpt-oss-120b-RotorQuant-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 "majentik/gpt-oss-120b-RotorQuant-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 majentik/gpt-oss-120b-RotorQuant-MLX-4bit
Run Hermes
hermes
- MLX LM
How to use majentik/gpt-oss-120b-RotorQuant-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 "majentik/gpt-oss-120b-RotorQuant-MLX-4bit"
Run an OpenAI-compatible server
# Install MLX LM uv tool install mlx-lm # Start the server mlx_lm.server --model "majentik/gpt-oss-120b-RotorQuant-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": "majentik/gpt-oss-120b-RotorQuant-MLX-4bit", "messages": [ {"role": "user", "content": "Hello"} ] }'
GPT-OSS-120B - RotorQuant MLX 4-bit
4-bit weight-quantized MLX version of openai/gpt-oss-120b with RotorQuant KV-cache quantization. Optimized for Apple Silicon inference via the MLX framework. RotorQuant delivers 5.3x faster prefill and 28% faster decode compared to TurboQuant. A good balance between model quality and memory efficiency, enabling GPT-OSS-120B to fit on high-memory Mac Studios. GPT-OSS-120B is OpenAI's flagship open-weights Mixture-of-Experts model (Apache 2.0), approaching o4-mini quality for reasoning tasks.
Approximate model size: ~65 GB
Model Specifications
| Property | Value |
|---|---|
| Base Model | openai/gpt-oss-120b |
| Parameters | 120 billion (MoE) |
| Architecture | Mixture-of-Experts (MoE) Transformer |
| License | Apache 2.0 (commercial use OK) |
| Weight Quantization | 4-bit (~65 GB) |
| KV-Cache Quantization | RotorQuant |
| Framework | MLX (Apple Silicon) |
Quickstart
from mlx_lm import load, generate
from rotorquant import IsoQuantCache
model, tokenizer = load("majentik/gpt-oss-120b-RotorQuant-MLX-4bit")
prompt = "Explain the theory of relativity."
response = generate(model, tokenizer, prompt=prompt, max_tokens=512)
print(response)
What is RotorQuant?
RotorQuant applies block-diagonal rotations (Clifford algebra) for KV cache compression. Combined with 4-bit weight quantization in MLX, this provides a dual compression strategy with superior KV-cache performance: smaller model weights plus faster compressed KV cache for efficient long-context generation.
Key advantages over TurboQuant:
- 5.3x faster prefill
- 28% faster decode
- Equivalent memory savings
KV-Cache Quantization Comparison
| Method | Prefill Speed | Decode Speed | Memory Savings | Reference |
|---|---|---|---|---|
| TurboQuant | 1x (baseline) | 1x (baseline) | High | arXiv: 2504.19874 |
| RotorQuant | 5.3x faster | 28% faster | High | GitHub |
Memory Estimates (GPT-OSS-120B)
| Precision | Approximate Size | MLX Variant |
|---|---|---|
| BF16 (original) | ~240 GB | -- |
| 8-bit quantized | ~120 GB | RotorQuant-MLX-8bit |
| 4-bit quantized | ~65 GB | This model |
| 2-bit quantized | ~30 GB | RotorQuant-MLX-2bit |
Hardware Requirements
This model requires approximately 65 GB of unified memory. Recommended hardware:
- Apple M2 Max (96 GB)
- Apple M2 Ultra (96 GB or 192 GB)
- Apple M3 Max (96 GB+) / M3 Ultra (192 GB+)
- Apple M4 Max / M4 Ultra (96 GB+)
See Also
- openai/gpt-oss-120b -- Base model
- majentik/gpt-oss-120b-RotorQuant -- RotorQuant KV-cache only (transformers)
- majentik/gpt-oss-120b-RotorQuant-MLX-8bit -- MLX 8-bit variant
- majentik/gpt-oss-120b-RotorQuant-MLX-2bit -- MLX 2-bit variant
- majentik/gpt-oss-120b-TurboQuant-MLX-4bit -- TurboQuant MLX 4-bit variant
- RotorQuant GitHub
- MLX Framework
Quant trade-off (MLX lane)
| Bits | Approx size | Use case | Recommendation |
|---|---|---|---|
| 2-bit | ~31 GB | Aggressive quantization | Very low-RAM Macs |
| 3-bit | ~43 GB | Lossy but small | Low-RAM Macs |
| 4-bit | ~50 GB | Balanced default | Recommended for most Macs |
| 5-bit | ~60 GB | Higher fidelity | Quality-sensitive |
| 6-bit | ~72 GB | Approaching FP16 quality | High-fidelity |
| 8-bit | ~91 GB | Near-lossless reference | Fidelity-critical work |
(Current variant — 4bit — is bolded.)
Variants in this family
(Showing 14 sibling variants under majentik/gpt-oss-120b-*. The current variant — RotorQuant-MLX-4bit — is bolded.)
| Variant | Runtime | Approx size | Use case |
|---|---|---|---|
| RotorQuant | runtime modifier | n/a | KV-cache root (weight-agnostic) |
| RotorQuant-GGUF-IQ4_XS | llama.cpp | ~103 GB | Lossy 4-bit, low-RAM CPU/edge |
| RotorQuant-GGUF-Q2_K | llama.cpp | ~72 GB | Lossy, low-RAM CPU/edge |
| RotorQuant-GGUF-Q3_K_M | llama.cpp | ~94 GB | Smaller 3-bit, CPU-friendly |
| RotorQuant-GGUF-Q4_K_M | llama.cpp | ~132 GB | Balanced default |
| RotorQuant-GGUF-Q5_K_M | llama.cpp | ~158 GB | Higher fidelity, more RAM |
| RotorQuant-GGUF-Q8_0 | llama.cpp | ~252 GB | Near-lossless reference |
| RotorQuant-MLX-2bit | mlx-lm | ~38 GB | Apple Silicon, smallest |
| RotorQuant-MLX-4bit | mlx-lm | ~74 GB | Apple Silicon balanced |
| RotorQuant-MLX-8bit | mlx-lm | ~142 GB | Apple Silicon reference |
| TurboQuant | runtime modifier | n/a | KV-cache root (weight-agnostic) |
| TurboQuant-MLX-2bit | mlx-lm | ~38 GB | Apple Silicon, smallest |
| TurboQuant-MLX-4bit | mlx-lm | ~74 GB | Apple Silicon balanced |
| TurboQuant-MLX-8bit | mlx-lm | ~142 GB | Apple Silicon reference |
- Downloads last month
- 260
4-bit
Model tree for majentik/gpt-oss-120b-RotorQuant-MLX-4bit
Base model
openai/gpt-oss-120b