Add README for Hugging Face Space

README.md

@@ -10,4 +10,62 @@ pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+---
+title: Tawalt
+emoji: 🌍
+colorFrom: blue
+colorTo: indigo
+sdk: gradio
+sdk_version: 6.9.0
+app_file: app.py
+pinned: true
+---
+
+# Tawalt 🌍 — The Language AI Forgot
+
+> The first conversational NLP pipeline built natively for Tarifit Berber.
+
+## What is Tawalt?
+
+Tarifit is a Berber language spoken by 5M+ people in Northern Morocco.
+No NLP model. No dataset. No chatbot. Nothing — until now.
+
+Tawalt is a real-time chat pipeline that understands and responds in Tarifit.
+
+## Features
+
+- 💬 Responds in Tarifit Berber
+- 🧠 Intent detection — greetings, questions, farewells, apologies
+- ✏️ Auto-corrects typos in Tarifit text
+- ⚡ Real-time message queue processing
+
+## Try it
+
+Type any of these to start:
+
+| Tarifit | Meaning |
+|---------|---------|
+| azul | hello |
+| sba7 lkhir | good morning |
+| manec t-llid? | how are you? |
+| sam7ahi | sorry |
+| ar nemzar | goodbye |
+
+## Tech Stack
+
+- Python 3
+- spaCy 3.8
+- rapidfuzz
+- Gradio
+
+## Links
+
+- 📓 Notebook: [Google Colab](https://github.com/jamalinu/tawalt)
+- 💻 Code: [GitHub](https://github.com/jamalinu/tawalt)
+
+## Status
+
+`v0.1 — Active development`
+
+750 million people speak low-resource languages invisible to modern AI.
+Tarifit is just the beginning.