Update README.md

README.md

@@ -4,10 +4,41 @@ emoji: 💬
 colorFrom: yellow
 colorTo: purple
 sdk: gradio
-sdk_version: 5.0.1
+sdk_version: 5.29.0
 app_file: app.py
 pinned: false
 license: mit
 ---
 
-An example chatbot using [Gradio](https://gradio.app), [`huggingface_hub`](https://huggingface.co/docs/huggingface_hub/v0.22.2/en/index), and the [Hugging Face Inference API](https://huggingface.co/docs/api-inference/index).
+# Swahili Hate Speech Classifier
+
+This Space is a demo of a fine-tuned BERT model for classifying Swahili text into three categories
+
+- **Non-hate speech**
+- **Political hate speech**
+- **Offensive language**
+
+### 🧠 Model
+The model was trained using a labeled Swahili dataset for hate speech detection. It is based on a BERT architecture and fine-tuned specifically for this 3-class classification task.
+
+Model repo: [`sandbox338/hatespeech`](https://huggingface.co/sandbox338/hatespeech)
+
+### 💬 How to Use
+1. Enter a Swahili sentence or paragraph into the textbox.
+2. Click **Submit**.
+3. The model will return one of the three class labels.
+
+### 🔍 Example Inputs
+- `Hii ni ujumbe wa kawaida bila matusi.` → *Non-hate speech*
+- `Wanasiasa hawa ni wabaya na lazima waondoke!` → *Political hate speech*
+- `Unasema upuuzi na wewe ni mjinga kabisa!` → *Offensive language*
+
+
+
+### 👩 Usability Testing
+This tool is part of an ongoing usability evaluation. Please try it out and share feedback on:
+- Clarity of results
+- Ease of use
+- Suggestions for improvement
+
+---