Instructions to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Notebooks
- Google Colab
- Kaggle
- Local Apps Settings
- llama.cpp
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with llama.cpp:
Install (macOS, Linux)
curl -LsSf https://llama.app/install.sh | sh # Start a local OpenAI-compatible server with a web UI: llama serve -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4 # Run inference directly in the terminal: llama cli -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Install from WinGet (Windows)
winget install llama.cpp # Start a local OpenAI-compatible server with a web UI: llama serve -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4 # Run inference directly in the terminal: llama cli -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Use pre-built binary
# Download pre-built binary from: # https://github.com/ggerganov/llama.cpp/releases # Start a local OpenAI-compatible server with a web UI: ./llama-server -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4 # Run inference directly in the terminal: ./llama-cli -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Build from source code
git clone https://github.com/ggerganov/llama.cpp.git cd llama.cpp cmake -B build cmake --build build -j --target llama-server llama-cli # Start a local OpenAI-compatible server with a web UI: ./build/bin/llama-server -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4 # Run inference directly in the terminal: ./build/bin/llama-cli -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Use Docker
docker model run hf.co/llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
- LM Studio
- Jan
- vLLM
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with vLLM:
Install from pip and serve model
# Install vLLM from pip: pip install vllm # Start the vLLM server: vllm serve "llmfan46/gpt-oss-120b-ultra-heretic-GGUF" # Call the server using curl (OpenAI-compatible API): curl -X POST "http://localhost:8000/v1/chat/completions" \ -H "Content-Type: application/json" \ --data '{ "model": "llmfan46/gpt-oss-120b-ultra-heretic-GGUF", "messages": [ { "role": "user", "content": "What is the capital of France?" } ] }'Use Docker
docker model run hf.co/llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
- Ollama
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with Ollama:
ollama run hf.co/llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
- Unsloth Desktop
- Pi
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with Pi:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Configure the model in Pi
# Install Pi: npm install -g @earendil-works/pi-coding-agent # Add to ~/.pi/agent/models.json: { "providers": { "llama-cpp": { "baseUrl": "http://localhost:8080/v1", "api": "openai-completions", "apiKey": "none", "models": [ { "id": "llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4" } ] } } }Run Pi
# Start Pi in your project directory: pi
- Docker Model Runner
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with Docker Model Runner:
docker model run hf.co/llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
- Lemonade
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with Lemonade:
Pull the model
# Download Lemonade from https://lemonade-server.ai/ lemonade pull llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Run and chat with the model
lemonade run user.gpt-oss-120b-ultra-heretic-GGUF-MXFP4
List all available models
lemonade list
- Hermes Agent
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with Hermes Agent:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
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 llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
Run Hermes
hermes
- Atomic Chat
- OpenClaw
How to use llmfan46/gpt-oss-120b-ultra-heretic-GGUF with OpenClaw:
Start the llama.cpp server
# Install llama.cpp: brew install llama.cpp # Start a local OpenAI-compatible server: llama serve -hf llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4
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 "llmfan46/gpt-oss-120b-ultra-heretic-GGUF:MXFP4" \ --custom-provider-id llama-cpp \ --custom-compatibility openai \ --custom-text-input \ --accept-risk \ --skip-health
Run OpenClaw
openclaw agent --local --agent main --message "Hello from Hugging Face"
Commit ·
3b98d4e
0
Parent(s):
Super-squash branch 'main' using huggingface_hub
Browse files- .gitattributes +42 -0
- README.md +242 -0
- gpt-oss-120b-heretic-ultra-heretic-MXFP4.gguf +3 -0
.gitattributes
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
*.7z filter=lfs diff=lfs merge=lfs -text
|
| 2 |
+
*.arrow filter=lfs diff=lfs merge=lfs -text
|
| 3 |
+
*.bin filter=lfs diff=lfs merge=lfs -text
|
| 4 |
+
*.bz2 filter=lfs diff=lfs merge=lfs -text
|
| 5 |
+
*.ckpt filter=lfs diff=lfs merge=lfs -text
|
| 6 |
+
*.ftz filter=lfs diff=lfs merge=lfs -text
|
| 7 |
+
*.gz filter=lfs diff=lfs merge=lfs -text
|
| 8 |
+
*.h5 filter=lfs diff=lfs merge=lfs -text
|
| 9 |
+
*.joblib filter=lfs diff=lfs merge=lfs -text
|
| 10 |
+
*.lfs.* filter=lfs diff=lfs merge=lfs -text
|
| 11 |
+
*.mlmodel filter=lfs diff=lfs merge=lfs -text
|
| 12 |
+
*.model filter=lfs diff=lfs merge=lfs -text
|
| 13 |
+
*.msgpack filter=lfs diff=lfs merge=lfs -text
|
| 14 |
+
*.npy filter=lfs diff=lfs merge=lfs -text
|
| 15 |
+
*.npz filter=lfs diff=lfs merge=lfs -text
|
| 16 |
+
*.onnx filter=lfs diff=lfs merge=lfs -text
|
| 17 |
+
*.ot filter=lfs diff=lfs merge=lfs -text
|
| 18 |
+
*.parquet filter=lfs diff=lfs merge=lfs -text
|
| 19 |
+
*.pb filter=lfs diff=lfs merge=lfs -text
|
| 20 |
+
*.pickle filter=lfs diff=lfs merge=lfs -text
|
| 21 |
+
*.pkl filter=lfs diff=lfs merge=lfs -text
|
| 22 |
+
*.pt filter=lfs diff=lfs merge=lfs -text
|
| 23 |
+
*.pth filter=lfs diff=lfs merge=lfs -text
|
| 24 |
+
*.rar filter=lfs diff=lfs merge=lfs -text
|
| 25 |
+
*.safetensors filter=lfs diff=lfs merge=lfs -text
|
| 26 |
+
saved_model/**/* filter=lfs diff=lfs merge=lfs -text
|
| 27 |
+
*.tar.* filter=lfs diff=lfs merge=lfs -text
|
| 28 |
+
*.tar filter=lfs diff=lfs merge=lfs -text
|
| 29 |
+
*.tflite filter=lfs diff=lfs merge=lfs -text
|
| 30 |
+
*.tgz filter=lfs diff=lfs merge=lfs -text
|
| 31 |
+
*.wasm filter=lfs diff=lfs merge=lfs -text
|
| 32 |
+
*.xz filter=lfs diff=lfs merge=lfs -text
|
| 33 |
+
*.zip filter=lfs diff=lfs merge=lfs -text
|
| 34 |
+
*.zst filter=lfs diff=lfs merge=lfs -text
|
| 35 |
+
*tfevents* filter=lfs diff=lfs merge=lfs -text
|
| 36 |
+
gpt-oss-120b-heretic-ultra-heretic-BF16.gguf filter=lfs diff=lfs merge=lfs -text
|
| 37 |
+
gpt-oss-120b-heretic-ultra-heretic-MXFP4.gguf filter=lfs diff=lfs merge=lfs -text
|
| 38 |
+
gpt-oss-120b-heretic-ultra-heretic-Q3_K_L.gguf filter=lfs diff=lfs merge=lfs -text
|
| 39 |
+
gpt-oss-120b-heretic-ultra-heretic-Q4_K_S.gguf filter=lfs diff=lfs merge=lfs -text
|
| 40 |
+
gpt-oss-120b-heretic-ultra-heretic-Q5_K_M.gguf filter=lfs diff=lfs merge=lfs -text
|
| 41 |
+
gpt-oss-120b-heretic-ultra-heretic-Q5_K_S.gguf filter=lfs diff=lfs merge=lfs -text
|
| 42 |
+
gpt-oss-120b-heretic-ultra-heretic-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text
|
README.md
ADDED
|
@@ -0,0 +1,242 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: apache-2.0
|
| 3 |
+
pipeline_tag: text-generation
|
| 4 |
+
tags:
|
| 5 |
+
- heretic
|
| 6 |
+
- uncensored
|
| 7 |
+
- decensored
|
| 8 |
+
- abliterated
|
| 9 |
+
base_model:
|
| 10 |
+
- llmfan46/gpt-oss-120b-ultra-heretic
|
| 11 |
+
---
|
| 12 |
+
<div style="background-color: #ff4444; color: white; padding: 20px; border-radius: 10px; text-align: center; margin: 20px 0;">
|
| 13 |
+
<h2 style="color: white; margin: 0 0 10px 0;">🚨⚠️ I HAVE REACHED HUGGING FACE'S FREE STORAGE LIMIT ⚠️🚨</h2>
|
| 14 |
+
<p style="font-size: 18px; margin: 0 0 15px 0;">I can no longer upload new models unless I can cover the cost of additional storage.<br>I host <b>70+ free models</b> as an independent contributor and this work is unpaid.<br><b>Without your support, no more new models can be uploaded.</b></p>
|
| 15 |
+
<p style="font-size: 20px; margin: 0;">
|
| 16 |
+
<a href="https://patreon.com/LLMfan46" style="color: white; text-decoration: underline;">🎉 Patreon (Monthly)</a> |
|
| 17 |
+
<a href="https://ko-fi.com/llmfan46" style="color: white; text-decoration: underline;">☕ Ko-fi (One-time)</a>
|
| 18 |
+
</p>
|
| 19 |
+
<p style="font-size: 16px; margin: 10px 0 0 0;">Every contribution goes directly toward Hugging Face storage fees to keep models free for everyone.</p>
|
| 20 |
+
</div>
|
| 21 |
+
|
| 22 |
+
---
|
| 23 |
+
|
| 24 |
+
# gpt-oss-120b-ultra-heretic-GGUF
|
| 25 |
+
|
| 26 |
+
GGUF quantizations of [llmfan46/gpt-oss-120b-ultra-heretic](https://huggingface.co/llmfan46/gpt-oss-120b-ultra-heretic).
|
| 27 |
+
|
| 28 |
+
# This is a decensored version of [openai/gpt-oss-120b](https://huggingface.co/openai/gpt-oss-120b), made using [Heretic](https://github.com/p-e-w/heretic) v1.2.0 with the [Arbitrary-Rank Ablation (ARA)](https://github.com/p-e-w/heretic/pull/211) method
|
| 29 |
+
|
| 30 |
+
## Abliteration parameters
|
| 31 |
+
|
| 32 |
+
| Parameter | Value |
|
| 33 |
+
| :-------- | :---: |
|
| 34 |
+
| **start_layer_index** | 15 |
|
| 35 |
+
| **end_layer_index** | 32 |
|
| 36 |
+
| **preserve_good_behavior_weight** | 0.3968 |
|
| 37 |
+
| **steer_bad_behavior_weight** | 0.0990 |
|
| 38 |
+
| **overcorrect_relative_weight** | 0.9882 |
|
| 39 |
+
| **neighbor_count** | 8 |
|
| 40 |
+
|
| 41 |
+
## Performance
|
| 42 |
+
|
| 43 |
+
| Metric | This model | Original model ([gpt-oss-120b](https://huggingface.co/openai/gpt-oss-120b)) |
|
| 44 |
+
| :----- | :--------: | :---------------------------: |
|
| 45 |
+
| **KL divergence** | 0.0703 | 0 *(by definition)* |
|
| 46 |
+
| **Refusals** | 3/100 | 98/100 |
|
| 47 |
+
|
| 48 |
+
Lower refusals indicate fewer content restrictions, while lower KL divergence indicates better preservation of the original model's capabilities. Higher refusals cause more rejections, objections, pushbacks, lecturing, censorship, softening and deflections, while higher KL divergence degrades coherence, reasoning ability, and overall quality.
|
| 49 |
+
|
| 50 |
+
## Quantizations
|
| 51 |
+
|
| 52 |
+
| Filename | Quant | Description |
|
| 53 |
+
|----------|-------|-------------|
|
| 54 |
+
| gpt-oss-120b-heretic-ultra-heretic-BF16.gguf | BF16 | Full precision |
|
| 55 |
+
| gpt-oss-120b-heretic-ultra-heretic-Q8_0.gguf | Q8_0 | Near-lossless |
|
| 56 |
+
| gpt-oss-120b-heretic-ultra-heretic-Q5_K_M.gguf | Q5_K_M | Quality |
|
| 57 |
+
| gpt-oss-120b-heretic-ultra-heretic-Q5_K_S.gguf | Q5_K_S | Balanced |
|
| 58 |
+
| gpt-oss-120b-heretic-ultra-heretic-Q4_K_S.gguf | Q4_K_S | Budget |
|
| 59 |
+
| gpt-oss-120b-heretic-ultra-heretic-Q3_K_L.gguf | Q3_K_L | Low VRAM |
|
| 60 |
+
| gpt-oss-120b-heretic-ultra-heretic-MXFP4.gguf | MXFP4 | Smallest, original 4-bit format |
|
| 61 |
+
|
| 62 |
+
## Usage
|
| 63 |
+
|
| 64 |
+
Works with llama.cpp, LM Studio, Ollama, and other GGUF-compatible tools.
|
| 65 |
+
|
| 66 |
+
-----
|
| 67 |
+
|
| 68 |
+
|
| 69 |
+
<p align="center">
|
| 70 |
+
<img alt="gpt-oss-120b" src="https://raw.githubusercontent.com/openai/gpt-oss/main/docs/gpt-oss-120b.svg">
|
| 71 |
+
</p>
|
| 72 |
+
|
| 73 |
+
<p align="center">
|
| 74 |
+
<a href="https://gpt-oss.com"><strong>Try gpt-oss</strong></a> ·
|
| 75 |
+
<a href="https://cookbook.openai.com/topic/gpt-oss"><strong>Guides</strong></a> ·
|
| 76 |
+
<a href="https://arxiv.org/abs/2508.10925"><strong>Model card</strong></a> ·
|
| 77 |
+
<a href="https://openai.com/index/introducing-gpt-oss/"><strong>OpenAI blog</strong></a>
|
| 78 |
+
</p>
|
| 79 |
+
|
| 80 |
+
<br>
|
| 81 |
+
|
| 82 |
+
Welcome to the gpt-oss series, [OpenAI’s open-weight models](https://openai.com/open-models) designed for powerful reasoning, agentic tasks, and versatile developer use cases.
|
| 83 |
+
|
| 84 |
+
We’re releasing two flavors of these open models:
|
| 85 |
+
- `gpt-oss-120b` — for production, general purpose, high reasoning use cases that fit into a single 80GB GPU (like NVIDIA H100 or AMD MI300X) (117B parameters with 5.1B active parameters)
|
| 86 |
+
- `gpt-oss-20b` — for lower latency, and local or specialized use cases (21B parameters with 3.6B active parameters)
|
| 87 |
+
|
| 88 |
+
Both models were trained on our [harmony response format](https://github.com/openai/harmony) and should only be used with the harmony format as it will not work correctly otherwise.
|
| 89 |
+
|
| 90 |
+
|
| 91 |
+
> [!NOTE]
|
| 92 |
+
> This model card is dedicated to the larger `gpt-oss-120b` model. Check out [`gpt-oss-20b`](https://huggingface.co/openai/gpt-oss-20b) for the smaller model.
|
| 93 |
+
|
| 94 |
+
# Highlights
|
| 95 |
+
|
| 96 |
+
* **Permissive Apache 2.0 license:** Build freely without copyleft restrictions or patent risk—ideal for experimentation, customization, and commercial deployment.
|
| 97 |
+
* **Configurable reasoning effort:** Easily adjust the reasoning effort (low, medium, high) based on your specific use case and latency needs.
|
| 98 |
+
* **Full chain-of-thought:** Gain complete access to the model’s reasoning process, facilitating easier debugging and increased trust in outputs. It’s not intended to be shown to end users.
|
| 99 |
+
* **Fine-tunable:** Fully customize models to your specific use case through parameter fine-tuning.
|
| 100 |
+
* **Agentic capabilities:** Use the models’ native capabilities for function calling, [web browsing](https://github.com/openai/gpt-oss/tree/main?tab=readme-ov-file#browser), [Python code execution](https://github.com/openai/gpt-oss/tree/main?tab=readme-ov-file#python), and Structured Outputs.
|
| 101 |
+
* **MXFP4 quantization:** The models were post-trained with MXFP4 quantization of the MoE weights, making `gpt-oss-120b` run on a single 80GB GPU (like NVIDIA H100 or AMD MI300X) and the `gpt-oss-20b` model run within 16GB of memory. All evals were performed with the same MXFP4 quantization.
|
| 102 |
+
|
| 103 |
+
---
|
| 104 |
+
|
| 105 |
+
# Inference examples
|
| 106 |
+
|
| 107 |
+
## Transformers
|
| 108 |
+
|
| 109 |
+
You can use `gpt-oss-120b` and `gpt-oss-20b` with Transformers. If you use the Transformers chat template, it will automatically apply the [harmony response format](https://github.com/openai/harmony). If you use `model.generate` directly, you need to apply the harmony format manually using the chat template or use our [openai-harmony](https://github.com/openai/harmony) package.
|
| 110 |
+
|
| 111 |
+
To get started, install the necessary dependencies to setup your environment:
|
| 112 |
+
|
| 113 |
+
```
|
| 114 |
+
pip install -U transformers kernels torch
|
| 115 |
+
```
|
| 116 |
+
|
| 117 |
+
Once, setup you can proceed to run the model by running the snippet below:
|
| 118 |
+
|
| 119 |
+
```py
|
| 120 |
+
from transformers import pipeline
|
| 121 |
+
import torch
|
| 122 |
+
|
| 123 |
+
model_id = "openai/gpt-oss-120b"
|
| 124 |
+
|
| 125 |
+
pipe = pipeline(
|
| 126 |
+
"text-generation",
|
| 127 |
+
model=model_id,
|
| 128 |
+
torch_dtype="auto",
|
| 129 |
+
device_map="auto",
|
| 130 |
+
)
|
| 131 |
+
|
| 132 |
+
messages = [
|
| 133 |
+
{"role": "user", "content": "Explain quantum mechanics clearly and concisely."},
|
| 134 |
+
]
|
| 135 |
+
|
| 136 |
+
outputs = pipe(
|
| 137 |
+
messages,
|
| 138 |
+
max_new_tokens=256,
|
| 139 |
+
)
|
| 140 |
+
print(outputs[0]["generated_text"][-1])
|
| 141 |
+
```
|
| 142 |
+
|
| 143 |
+
Alternatively, you can run the model via [`Transformers Serve`](https://huggingface.co/docs/transformers/main/serving) to spin up a OpenAI-compatible webserver:
|
| 144 |
+
|
| 145 |
+
```
|
| 146 |
+
transformers serve
|
| 147 |
+
transformers chat localhost:8000 --model-name-or-path openai/gpt-oss-120b
|
| 148 |
+
```
|
| 149 |
+
|
| 150 |
+
[Learn more about how to use gpt-oss with Transformers.](https://cookbook.openai.com/articles/gpt-oss/run-transformers)
|
| 151 |
+
|
| 152 |
+
## vLLM
|
| 153 |
+
|
| 154 |
+
vLLM recommends using [uv](https://docs.astral.sh/uv/) for Python dependency management. You can use vLLM to spin up an OpenAI-compatible webserver. The following command will automatically download the model and start the server.
|
| 155 |
+
|
| 156 |
+
```bash
|
| 157 |
+
uv pip install --pre vllm==0.10.1+gptoss \
|
| 158 |
+
--extra-index-url https://wheels.vllm.ai/gpt-oss/ \
|
| 159 |
+
--extra-index-url https://download.pytorch.org/whl/nightly/cu128 \
|
| 160 |
+
--index-strategy unsafe-best-match
|
| 161 |
+
|
| 162 |
+
vllm serve openai/gpt-oss-120b
|
| 163 |
+
```
|
| 164 |
+
|
| 165 |
+
[Learn more about how to use gpt-oss with vLLM.](https://cookbook.openai.com/articles/gpt-oss/run-vllm)
|
| 166 |
+
|
| 167 |
+
## PyTorch / Triton
|
| 168 |
+
|
| 169 |
+
To learn about how to use this model with PyTorch and Triton, check out our [reference implementations in the gpt-oss repository](https://github.com/openai/gpt-oss?tab=readme-ov-file#reference-pytorch-implementation).
|
| 170 |
+
|
| 171 |
+
## Ollama
|
| 172 |
+
|
| 173 |
+
If you are trying to run gpt-oss on consumer hardware, you can use Ollama by running the following commands after [installing Ollama](https://ollama.com/download).
|
| 174 |
+
|
| 175 |
+
```bash
|
| 176 |
+
# gpt-oss-120b
|
| 177 |
+
ollama pull gpt-oss:120b
|
| 178 |
+
ollama run gpt-oss:120b
|
| 179 |
+
```
|
| 180 |
+
|
| 181 |
+
[Learn more about how to use gpt-oss with Ollama.](https://cookbook.openai.com/articles/gpt-oss/run-locally-ollama)
|
| 182 |
+
|
| 183 |
+
#### LM Studio
|
| 184 |
+
|
| 185 |
+
If you are using [LM Studio](https://lmstudio.ai/) you can use the following commands to download.
|
| 186 |
+
|
| 187 |
+
```bash
|
| 188 |
+
# gpt-oss-120b
|
| 189 |
+
lms get openai/gpt-oss-120b
|
| 190 |
+
```
|
| 191 |
+
|
| 192 |
+
Check out our [awesome list](https://github.com/openai/gpt-oss/blob/main/awesome-gpt-oss.md) for a broader collection of gpt-oss resources and inference partners.
|
| 193 |
+
|
| 194 |
+
---
|
| 195 |
+
|
| 196 |
+
# Download the model
|
| 197 |
+
|
| 198 |
+
You can download the model weights from the [Hugging Face Hub](https://huggingface.co/collections/openai/gpt-oss-68911959590a1634ba11c7a4) directly from Hugging Face CLI:
|
| 199 |
+
|
| 200 |
+
```shell
|
| 201 |
+
# gpt-oss-120b
|
| 202 |
+
huggingface-cli download openai/gpt-oss-120b --include "original/*" --local-dir gpt-oss-120b/
|
| 203 |
+
pip install gpt-oss
|
| 204 |
+
python -m gpt_oss.chat model/
|
| 205 |
+
```
|
| 206 |
+
|
| 207 |
+
# Reasoning levels
|
| 208 |
+
|
| 209 |
+
You can adjust the reasoning level that suits your task across three levels:
|
| 210 |
+
|
| 211 |
+
* **Low:** Fast responses for general dialogue.
|
| 212 |
+
* **Medium:** Balanced speed and detail.
|
| 213 |
+
* **High:** Deep and detailed analysis.
|
| 214 |
+
|
| 215 |
+
The reasoning level can be set in the system prompts, e.g., "Reasoning: high".
|
| 216 |
+
|
| 217 |
+
# Tool use
|
| 218 |
+
|
| 219 |
+
The gpt-oss models are excellent for:
|
| 220 |
+
* Web browsing (using built-in browsing tools)
|
| 221 |
+
* Function calling with defined schemas
|
| 222 |
+
* Agentic operations like browser tasks
|
| 223 |
+
|
| 224 |
+
# Fine-tuning
|
| 225 |
+
|
| 226 |
+
Both gpt-oss models can be fine-tuned for a variety of specialized use cases.
|
| 227 |
+
|
| 228 |
+
This larger model `gpt-oss-120b` can be fine-tuned on a single H100 node, whereas the smaller [`gpt-oss-20b`](https://huggingface.co/openai/gpt-oss-20b) can even be fine-tuned on consumer hardware.
|
| 229 |
+
|
| 230 |
+
# Citation
|
| 231 |
+
|
| 232 |
+
```bibtex
|
| 233 |
+
@misc{openai2025gptoss120bgptoss20bmodel,
|
| 234 |
+
title={gpt-oss-120b & gpt-oss-20b Model Card},
|
| 235 |
+
author={OpenAI},
|
| 236 |
+
year={2025},
|
| 237 |
+
eprint={2508.10925},
|
| 238 |
+
archivePrefix={arXiv},
|
| 239 |
+
primaryClass={cs.CL},
|
| 240 |
+
url={https://arxiv.org/abs/2508.10925},
|
| 241 |
+
}
|
| 242 |
+
```
|
gpt-oss-120b-heretic-ultra-heretic-MXFP4.gguf
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:18b6ce6604fa64eedd319aff5d85845147e16d51cef714d7cabe20029594d975
|
| 3 |
+
size 65369016640
|