Update README.md

README.md

@@ -10,19 +10,49 @@ pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
-# EvoTransformer Reasoning API
+# 🧠 EvoTransformer – The AI That Evolves
 
-This app lets you ask EvoTransformer a physical or commonsense reasoning question with two answer options. It predicts which one makes more sense — powered by our evolved transformer architecture.
+**Why Evo?**  
+Most AI models are frozen in time. Evo learns. Evo mutates. Evo survives.  
+It evolves its architecture based on **your feedback** — live.
 
-Try scenarios like:
+### 🧬 Core Features
+- Learns from your questions and feedback
+- Evolving Transformer architecture (layers, attention heads, FFN dim, memory)
+- GPT-3.5 comparison built in
+- No manual fine-tuning – Evo retrains live
+- Live architecture mutation + genome tracking
 
-- "You spilled juice on the floor"
-- Option 1: Clean it with a towel
-- Option 2: Cover it with a rug
+### 🛠️ Tech Stack
+- PyTorch
+- Transformers (tokenizer only)
+- Gradio (interactive UI)
+- Hugging Face or Local/Colab
+- OpenAI API (for GPT-3.5 comparison)
+
+---
+
+### 🚀 Try it out
+
+> Ask Evo a question. Choose two options. It tells you which makes more sense — and why.  
+> Then **vote on who was better: Evo or GPT**. Evo adapts live.
+
+---
+
+### 💡 Example:
+**Q**: Blue is a  
+**Option 1**: Color  
+**Option 2**: Fruit  
+**Evo Answer**: Color (Reasoning: 0.497 vs 0.431)  
+**GPT-3.5 Answer**: color
+
+You vote ✅ Evo → Evo learns from that and retrains in real time.
+
+---
+
+### 🧠 Evo isn't trained.
+Evo **learns to train itself**.
 
-Evo will suggest the most logical option and show confidence scores.
 
-> Built by Dr. Heman Mohabeer 🇲🇺 — EvoTransformer: The African AI platform that learns live.