Update README.md

README.md

@@ -1,6 +1,6 @@
 ---
-title: Eng Amh Tts
-emoji: 😻
+title: 'Bilingual TTS: Amharic & English'
+emoji: 🌍
 colorFrom: gray
 colorTo: purple
 sdk: gradio
@@ -11,4 +11,88 @@ license: mit
 short_description: Bilingual Text-to-Speech (Amharic & English) 🇪🇹🇺🇸
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+Here's a Hugging Face Spaces-optimized README.md:
+
+```markdown
+---
+title: "🌍 Bilingual TTS: Amharic & English"
+emoji: "🇪🇹🇺🇸"
+colorFrom: "pink"
+colorTo: "blue"
+sdk: "gradio"
+sdk_version: "4.13.0"
+app_file: "app.py"
+pinned: false
+license: "mit"
+---
+
+# Bilingual Text-to-Speech Converter
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/snackshell/eng-amh-tts/main/assets/demo.png" width="800" alt="Bilingual TTS Interface">
+  <br>
+  <em>Natural sounding speech synthesis for Amharic and English</em>
+</div>
+
+[![Open in Spaces](https://img.shields.io/badge/🤗-Try%20Live-blue)](https://huggingface.co/spaces/snackshell/eng-amh-tts)
+
+## Key Features 🌟
+- **Bilingual Support**: Switch between Amharic & English seamlessly
+- **Four Natural Voices**:
+  - 🇪🇹 Amharic: Ameha (Male) & Mekdes (Female)
+  - 🇺🇸 English: Ryan (Male) & Clara (Female)
+- **Real-time Generation**: <3s response time for most requests
+- **Gradient UI**: Beautiful pink-to-blue theme
+- **Cross-language Error Handling**: Automatic error messages in selected language
+
+## How to Use 🎤
+1. **Select Language**: Choose between Amharic/English
+2. **Choose Voice**: Pick your preferred speaker
+3. **Enter Text**: Type or paste your text (max 500 characters)
+4. **Generate**: Click the gradient button
+5. **Play**: Listen directly in your browser
+
+![Usage Demo](https://raw.githubusercontent.com/snackshell/eng-amh-tts/main/assets/usage-demo.gif)
+
+## Supported Voices 🎧
+| Language  | Speaker | Gender | Voice ID           |
+|-----------|---------|--------|--------------------|
+| Amharic 🇪🇹 | Ameha   | Male   | `am-ET-AmehaNeural`|
+| Amharic 🇪🇹 | Mekdes  | Female | `am-ET-MekdesNeural`|
+| English 🇺🇸 | Ryan    | Male   | `en-GB-RyanNeural` |
+| English 🇺🇸 | Clara   | Female | `en-CA-ClaraNeural`|
+
+## Technical Flow 🔧
+```mermaid
+sequenceDiagram
+    User->>+App: Select Language & Voice
+    User->>+App: Input Text
+    App->>+EdgeTTS: Send Request
+    EdgeTTS-->>-App: Return Audio
+    App->>+User: Play Audio
+```
+
+## Local Development 💻
+```bash
+git clone https://github.com/snackshell/eng-amh-tts.git
+cd bilingual-tts
+pip install -r requirements.txt
+python app.py
+```
+
+## Limitations ⚠️
+- Max 500 characters per request
+- Requires internet connection
+- English voices optimized for neutral accents
+
+## Acknowledgments 🙏
+- Voice Technology: Microsoft Edge TTS
+- Hosting: Hugging Face Spaces
+- UI Framework: Gradio
+- Maintained by: [Bana Codes](https://t.me/banacodes)
+
+[📚 GitHub Repository](https://github.com/snackshell/eng-amh-tts) | [🐛 Report Issues](https://github.com/snackshell/eng-amh-tts/issues)
+
+```
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference