README.md

---
title: 'Bilingual TTS: Amharic & English'
emoji: 🌍
colorFrom: gray
colorTo: purple
sdk: gradio
sdk_version: 5.22.0
app_file: app.py
pinned: false
license: mit
short_description: Bilingual Text-to-Speech (Amharic & English) 🇪🇹🇺🇸
---

# 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