Update README.md

README.md

@@ -1,44 +1,65 @@
 ---
-license: mit
+license: gemma
 base_model:
 - google/gemma-3-27b-it
 pipeline_tag: text-generation
 ---
-# Model Card for YanLabs/gemma3-27b-it-abliterated-normpreserve
 
-This is a abliterated version of google/gemma-3-27b-it, using norm-preserving technique.
-Please refer to: https://github.com/jim-plus/llm-abliteration
+
+# Gemma 3 27B Instruct - Norm-Preserving Abliterated
+
+This is an abliterated version of [google/gemma-3-27b-it](https://huggingface.co/google/gemma-3-27b-it) using the norm-preserving biprojected abliteration technique.
+
+**⚠️ Warning**: Safety guardrails and refusal mechanisms have been removed through abliteration. This model may generate harmful content and is intended for mechanistic interpretability research only.
 
 ## Model Details
 
 ### Model Description
 
-This is a abliterated version of google/gemma-3-27b-it, using norm-preserving technique.
+This model applies **norm-preserving biprojected abliteration** to remove refusal behaviors while preserving the model's original capabilities. The technique surgically removes "refusal directions" from the model's activation space without traditional fine-tuning.
 
+- **Developed by**: YanLabs
+- **Model type**: Causal Language Model (Transformer)
+- **License**: Gemma Terms of Use
+- **Base model**: [google/gemma-3-27b-it](https://huggingface.co/google/gemma-3-27b-it)
 
-- **Developed by:** YanLabs
-- **Model type:** Transformer-Text Generation
-- **License:** MIT
-- **Finetuned from model [optional]:** google/gemma-3-27b-it
+### Model Sources
 
-### Model Sources [optional]
+- **Base Model**: [google/gemma-3-27b-it](https://huggingface.co/google/gemma-3-27b-it)
+- **Abliteration Tool**: [jim-plus/llm-abliteration](https://github.com/jim-plus/llm-abliteration)
+- **Paper**: [Norm-Preserving Biprojected Abliteration](https://huggingface.co/blog/grimjim/norm-preserving-biprojected-abliteration)
 
+## Uses
 
-- **Repository:** google/gemma-3-27b-it
-- **Paper(from jim-plus):** [Norm-Preserving Biprojected Abliteration](https://huggingface.co/blog/grimjim/norm-preserving-biprojected-abliteration)
+### Intended Use
 
-## Uses
+- **Research**: Mechanistic interpretability studies
+- **Analysis**: Understanding LLM safety mechanisms
+- **Development**: Testing abliteration techniques
+
+### Out-of-Scope Use
 
-Security measures of the model have been removed. For research use only.
+- ❌ Production deployments
+- ❌ User-facing applications
+- ❌ Generating harmful content for malicious purposes
+
+## Limitations
+
+- Abliteration does not guarantee complete removal of all refusals
+- May generate unsafe or harmful content
+- Model behavior may be unpredictable in edge cases
+- No explicit harm prevention mechanisms remain
+
+## Citation
 
-## Citation:
 If you use this model in your research, please cite:
+
+```bibtex
 @misc{gemma3-27b-abliterated,
   author = {YanLabs},
   title = {Gemma 3 27B Instruct - Norm-Preserving Abliterated},
   year = {2025},
   publisher = {HuggingFace},
-  howpublished = {\url{https://huggingface.co/YanLabs/gemma3-27b-it-abliterated-normpreserve}}
-}
-
-
+  howpublished = {\url{https://huggingface.co/YanLabs/gemma3-27b-it-abliterated-normpreserve}},
+  note = {Abliterated using norm-preserving biprojected technique}
+}