README.md

---
license: mit
title: Amharic Text-to-Speech (TTS)
sdk: gradio
emoji: 💻
colorFrom: purple
colorTo: pink
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/6717556a4777a008d5050cba/urQjnIAwtM0Pm6coyh4A7.png
short_description: 'Amharic Text-to-Speech Application. '
sdk_version: 5.22.0
---

# Amharic Text-to-Speech (TTS) Application

<div align="center">
  <img src="https://raw.githubusercontent.com/snackshell/amharic-tts/main/assets/demo.png" alt="Amharic TTS Interface" width="800">
  <br>
  <em>Convert Amharic text to natural-sounding speech directly in your browser</em>
</div>

[![Open in Spaces](https://img.shields.io/badge/🤗-Open%20in%20Spaces-blue.svg)](https://huggingface.co/spaces/snackshell/amharic-tts)

## 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 🔧
```mermaid
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)

## License 📄
This project is licensed under the [MIT License](LICENSE)

## Acknowledgments 🙏
- Microsoft Edge TTS services
- Hugging Face for hosting
- Gradio team for the web framework
- Ethiopian tech community for support

[📁 GitHub Repository](https://github.com/snackshell/amharic-tts) | [🐛 Report Issues](https://github.com/snackshell/amharic-tts/issues)
```

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference