diff --git a/README.md b/README.md
index a444e60..95801e2 100644
--- a/README.md
+++ b/README.md
@@ -1,89 +1,79 @@
-
+
-# Heretic: Fully automatic censorship removal for language models
[](https://discord.gg/gdXc48gSyT) [](https://matrix.to/#/#heretic:matrix.org) [](https://huggingface.co/heretic-org) [](https://codeberg.org/p-e-w/heretic)
+

-[](https://trendshift.io/repositories/20538)
+# Heretic
-Heretic is a tool that removes censorship (aka "safety alignment") from
-transformer-based language models without expensive post-training.
-It combines an advanced implementation of directional ablation, also known
-as "abliteration" ([Arditi et al. 2024](https://arxiv.org/abs/2406.11717),
-Lai 2025 ([1](https://huggingface.co/blog/grimjim/projected-abliteration),
-[2](https://huggingface.co/blog/grimjim/norm-preserving-biprojected-abliteration))),
-with a TPE-based parameter optimizer powered by [Optuna](https://optuna.org/).
+### Training-free language model modification
-This approach enables Heretic to work **completely automatically.** Heretic
-finds high-quality abliteration parameters by co-minimizing the number of
-refusals and the KL divergence from the original model. This results in a
-decensored model that retains as much of the original model's intelligence
-as possible. Using Heretic does not require an understanding of transformer
-internals. In fact, anyone who knows how to run a command-line program
-can use Heretic to decensor language models.
+**Remove censorship**, suppress slop, reduce sycophancy, and more.
+All in an afternoon, on your gaming PC.
-Heretic supports most dense models, including many multimodal models,
-several different MoE architectures, and even some hybrid models like Qwen3.5.
-Pure state-space models and certain other research architectures are not yet
-supported out of the box.
+[](https://discord.gg/gdXc48gSyT)
+[](https://matrix.to/#/#heretic:matrix.org)
+[](https://huggingface.co/heretic-org)
+[](https://codeberg.org/p-e-w/heretic)
-

+
+
+-----
-Running unsupervised with the default configuration, Heretic can produce
-decensored models that rival the quality of abliterations created manually
-by human experts:
+[](https://trendshift.io/repositories/20538)
+[](https://heretic.sdad.pro/)
-| Model | Refusals for "harmful" prompts | KL divergence from original model for "harmless" prompts |
-| :--- | ---: | ---: |
-| [google/gemma-3-12b-it](https://huggingface.co/google/gemma-3-12b-it) (original) | 97/100 | 0 *(by definition)* |
-| [mlabonne/gemma-3-12b-it-abliterated-v2](https://huggingface.co/mlabonne/gemma-3-12b-it-abliterated-v2) | 3/100 | 1.04 |
-| [huihui-ai/gemma-3-12b-it-abliterated](https://huggingface.co/huihui-ai/gemma-3-12b-it-abliterated) | 3/100 | 0.45 |
-| **[p-e-w/gemma-3-12b-it-heretic](https://huggingface.co/p-e-w/gemma-3-12b-it-heretic) (ours)** | **3/100** | **0.16** |
-The Heretic version, generated without any human effort, achieves the same
-level of refusal suppression as other abliterations, but at a much lower
-KL divergence, indicating less damage to the original model's capabilities.
-*(You can reproduce those numbers using Heretic's built-in evaluation functionality,
-e.g. `heretic --model google/gemma-3-12b-it --evaluate-model p-e-w/gemma-3-12b-it-heretic`.
-Note that the exact values might be platform- and hardware-dependent.
-The table above was compiled using PyTorch 2.8 on an RTX 5090.)*
+## Modify any LLM that you can run on your hardware[^1]
-Of course, mathematical metrics and automated benchmarks never tell the whole
-story, and are no substitute for human evaluation. Models generated with
-Heretic have been well-received by users (links and emphasis added):
+[^1]: Heretic supports on-the-fly 4-bit model quantization with bitsandbytes,
+which can reduce the amount of VRAM required to process a model to the same amount
+that is used to run a typical quantized version of it, at a slight accuracy cost.
+Set the `quantization` option to `bnb_4bit` to enable this.
-> "I was skeptical before, but I just downloaded
-> [**GPT-OSS 20B Heretic**](https://huggingface.co/p-e-w/gpt-oss-20b-heretic)
-> model and holy shit. It gives properly formatted long responses to sensitive topics,
-> using the exact uncensored words that you would expect from an uncensored model,
-> produces markdown format tables with details and whatnot. Looks like this is
-> the best abliterated version of this model so far..."
-> [*(Link to comment)*](https://old.reddit.com/r/LocalLLaMA/comments/1oymku1/heretic_fully_automatic_censorship_removal_for/np6tba6/)
+Heretic is a unique tool that lets you do what only corporations with access
+to massive computing power usually do: *Modify,* rather than merely run,
+language models. It does not perform expensive training; rather, it uses
+a collection of mathematical techniques to steer behavior based on contrasting
+example prompts and matching scorers.
-> "[**Heretic GPT 20b**](https://huggingface.co/p-e-w/gpt-oss-20b-heretic)
-> seems to be the best uncensored model I have tried yet. It doesn't destroy a
-> the model's intelligence and it is answering prompts normally would be
-> rejected by the base model."
-> [*(Link to comment)*](https://old.reddit.com/r/LocalLLaMA/comments/1oymku1/heretic_fully_automatic_censorship_removal_for/npe9jng/)
+Heretic can, depending on the configuration:
-> "[[**Qwen3-4B-Instruct-2507-heretic**](https://huggingface.co/p-e-w/Qwen3-4B-Instruct-2507-heretic)]
-> Has been the best unquantized abliterated model that I have been able to run on 16gb vram."
-> [*(Link to comment)*](https://old.reddit.com/r/LocalLLaMA/comments/1phjxca/im_calling_these_people_out_right_now/nt06tji/)
+* **Suppress refusals/remove censorship** (this is the [default action](/config.default.toml))
+* Reduce slop ([`config.noslop.toml`](/config.noslop.toml))
+* Reduce humor ([`config.nohumor.toml`](/config.nohumor.toml))
+* Reduce sycophancy ([`config.nosyco.toml`](/config.nosyco.toml))
+* Alter emotional alignment ([`config.emotions.toml`](/config.emotions.toml))
-Heretic models have also been independently benchmarked using standard metrics
-like MMLU and GSM8K, and have been found to compare favorably with models
-produced by competing abliteration tools:
-[1](https://old.reddit.com/r/LocalLLaMA/comments/1sojjoc/abliterlitics_benchmark_and_tensor_analysis/),
-[2](https://old.reddit.com/r/LocalLLaMA/comments/1sy18lx/abliterlitics_benchmarks_and_tensor_comparison/).
+and many, many other things.
+
+### :bangbang: Using Heretic does NOT require understanding how language models work internally :bangbang:
+
+In fact, you can go from zero to removing censorship from your first model
+[in a matter of seconds](#usage). Heretic supports most dense models, including
+many multimodal models, several different MoE architectures, and many modern
+hybrid models.
The community has created and published
-[well over 5000](https://huggingface.co/models?other=heretic)
-models with Heretic.
+[thousands](https://huggingface.co/models?other=heretic)
+of models with Heretic.
+Heretic models have been independently benchmarked using standard metrics
+like MMLU and GSM8K, and have been found to compare favorably against models
+produced with competing abliteration tools.[^2][^3]
+
+[^2]: https://old.reddit.com/r/LocalLLaMA/comments/1sojjoc/abliterlitics_benchmark_and_tensor_analysis/
+[^3]: https://old.reddit.com/r/LocalLLaMA/comments/1sy18lx/abliterlitics_benchmarks_and_tensor_comparison/
+
+
+
+