Update README.md

README.md

@@ -10,18 +10,36 @@ pinned: false
 license: apache-2.0
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+'''
+# EvoTransformer v2.1 🧠✨
 
-# 🧬 EvoTransformer v2.1 – Evolving Transformer Architectures
+EvoTransformer is an evolving neural architecture built from scratch to tackle reasoning tasks with minimal compute.
 
-Built by **Dr. Heman Mohabeer**, EvoTransformer is a lightweight evolution-based transformer that adapts its architecture to perform reasoning tasks — especially PIQA — and is benchmarked live against GPT-3.5.
+## 📌 What It Does
+This model answers PIQA-style commonsense reasoning questions. Given a goal and two solution choices, EvoTransformer chooses the more logical one.
 
-🔹 Built from scratch  
-🔹 ~13M Parameters  
-🔹 Runs in under 10 seconds  
-🔹 Trains on-the-fly with few-shot examples
+## 🔧 Architecture
+- Built with 4 Transformer encoder layers
+- ~13 million parameters
+- Custom embedding, pooling, and classifier layers
+- Fully open and adaptable for NAS or self-evolving tasks
 
-Try the interactive benchmark demo and see how it compares with GPT-3.5!
+## 🏋️‍♂️ Training Details
+- Dataset: PIQA (1000 training, 500 validation examples)
+- Optimizer: Adam
+- Loss: CrossEntropy
+- Epochs: 5
+- Hardware: Colab GPU
 
-📘 Featured in the book: [I Was Never Just Code](https://www.amazon.com/dp/B0FHG443LL)
+## 🚀 Live Demo
+Try it on Hugging Face Spaces:
+👉 [Demo Link](https://huggingface.co/spaces/YOUR_USERNAME/evo-transformer-demo)
 
+## 💡 Why EvoTransformer?
+- Lean, fast, and efficient
+- Custom-built from scratch (no pretraining dependencies)
+- Can evolve structurally in future versions
+
+## 📜 License
+MIT
+'''