README.md

```markdown
```
---
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

<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)

## Local Development 💻
```bash
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](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)
```

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.