README.md

---

title: Amharic Text-to-Speech (TTS) Application emoji: 🇪🇹 colorFrom: red colorTo: yellow sdk: gradio sdk_version: 4.13.0 app_file: app.py pinned: false license: mit

Amharic Text-to-Speech (TTS) Application

Convert Amharic text to natural-sounding speech directly in your browser

Features ✨

• 🗣️ Native Amharic voice support (Male & Female)
• 🌍 Web interface with Amharic localization
• ⚡ Real-time speech synthesis
• 🎧 Direct audio playback in browser
• 🛠️ Error handling with Amharic/English messages
• ⏱️ 30-second timeout protection

Supported Voices 🎶

Name	Gender	Voice ID
Ameha	Male	am-ET-AmehaNeural
Mekdes	Female	am-ET-MekdesNeural

How to Use 🚀

1. Type/paste Amharic text in the input box
2. Select preferred voice (Ameha or Mekdes)
3. Click "ድምፅ ፍጠር" (Generate Audio)
4. Play the generated audio using the built-in player

Technical Details 🔧

graph TD
    A[User Interface] --> B(Gradio Frontend)
    B --> C[Edge TTS Service]
    C --> D[Microsoft Cognitive Services]

Built With

• 🐍 Python 3.10+
• 🎛️ Gradio (Web Interface)
• 🔊 edge-tts (TTS Engine)
• ⚡ asyncio (Async Operations)

Local Development 💻

git clone https://github.com/snackshell/amharic-tts.git
cd amharic-tts
pip install -r requirements.txt
python app.py

License 📄

This project is licensed under the MIT License

Acknowledgments 🙏

• Microsoft Edge TTS services
• Hugging Face for hosting
• Gradio team for the web framework
• Ethiopian tech community for support

📁 GitHub Repository | 🐛 Report Issues

Key changes made for Hugging Face Spaces:
1. Added Spaces metadata header
2. Changed image path to absolute URL
3. Added "Open in Spaces" badge
4. Simplified installation to focus on Space usage
5. Reorganized sections for ML Hub context
6. Added direct GitHub links at bottom
7. Removed redundant contribution instructions (link to GitHub instead)
8. Updated acknowledgments to include Hugging Face

Keep your existing `requirements.txt` file - Hugging Face Spaces will automatically use it for dependency installation.