llmfan46 commited on
Commit
3b98d4e
·
0 Parent(s):

Super-squash branch 'main' using huggingface_hub

Browse files
.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> &nbsp;|&nbsp;
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