snackshell commited on
Commit
ca276e4
ยท
verified ยท
1 Parent(s): 4ea70c7

Update README.md

Browse files
Files changed (1) hide show
  1. README.md +98 -7
README.md CHANGED
@@ -1,14 +1,105 @@
 
 
 
1
  ---
2
- title: Selam Tts
3
- emoji: ๐Ÿš€
4
- colorFrom: purple
5
- colorTo: pink
6
  sdk: gradio
7
- sdk_version: 5.42.0
8
  app_file: app.py
9
  pinned: false
10
  license: mit
11
- short_description: Multilingual Text-to-Speech
12
  ---
13
 
14
- Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ -----
2
+
3
+ ````markdown
4
  ---
5
+ title: 'Multilingual TTS: Amharic, Oromo, Somali, English & More'
6
+ emoji: ๐ŸŒ
7
+ colorFrom: gray
8
+ colorTo: purple
9
  sdk: gradio
10
+ sdk_version: 4.31.5
11
  app_file: app.py
12
  pinned: false
13
  license: mit
14
+ short_description: High-quality Text-to-Speech for Amharic, Oromo, Somali, English, Arabic, French, and more.
15
  ---
16
 
17
+ # Multilingual Text-to-Speech Converter
18
+
19
+ <div align="center">
20
+ <img src="httpshttps://raw.githubusercontent.com/snackshell/eng-amh-tts/main/assets/demo.png" width="800" alt="Multilingual TTS Interface">
21
+ <br>
22
+ <em>Natural sounding speech synthesis for a wide variety of languages.</em>
23
+ </div>
24
+
25
+ [![Open in Spaces](https://img.shields.io/badge/๐Ÿค—-Try%20Live-blue)](https://huggingface.co/spaces/snackshell/selam-tts)
26
+
27
+ ## Key Features ๐ŸŒŸ
28
+ - **Multilingual Support**: Seamlessly generate speech for Amharic, Oromo, Somali, Tigrinya, English, Arabic, French, German, Italian, Japanese, Korean, and Chinese.
29
+ - **Multiple Natural Voices**: Each language comes with distinct male and female speaker options.
30
+ - **Smart Fallbacks**: Unsupported languages like Tigrinya and Oromo use the closest available high-quality voice for pronunciation.
31
+ - **Real-time Generation**: Fast response time for most requests.
32
+ - **Modern UI**: Clean and easy-to-use interface powered by Gradio.
33
+
34
+ ## How to Use ๐ŸŽค
35
+ 1. **Select Language**: Choose your desired language from the dropdown.
36
+ 2. **Choose Voice**: Pick your preferred speaker.
37
+ 3. **Enter Text**: Type or paste your text.
38
+ 4. **Generate**: Click the "Generate Audio" button.
39
+ 5. **Play**: Listen directly in your browser.
40
+
41
+ ## Supported Voices ๐ŸŽง
42
+ | Language | Speaker | Gender | Voice ID / Fallback |
43
+ | :--- | :--- | :--- | :--- |
44
+ | Amharic ๐Ÿ‡ช๐Ÿ‡น | Mekdes | Female | `am-ET-MekdesNeural` |
45
+ | Amharic ๐Ÿ‡ช๐Ÿ‡น | Ameha | Male | `am-ET-AmehaNeural` |
46
+ | Oromo ๐Ÿ‡ช๐Ÿ‡น | Zuri | Female | `sw-KE-ZuriNeural` (Swahili) |
47
+ | Oromo ๐Ÿ‡ช๐Ÿ‡น | Rafiki | Male | `sw-KE-RafikiNeural` (Swahili) |
48
+ | Somali ๐Ÿ‡ธ๐Ÿ‡ด | Ubax | Female | `so-SO-UbaxNeural` |
49
+ | Somali ๐Ÿ‡ธ๐Ÿ‡ด | Muuse | Male | `so-SO-MuuseNeural` |
50
+ | Tigrinya ๐Ÿ‡ช๐Ÿ‡ท | Lulia | Female | `am-ET-MekdesNeural` (Amharic)|
51
+ | Tigrinya ๐Ÿ‡ช๐Ÿ‡ท | Birhane | Male | `am-ET-AmehaNeural` (Amharic)|
52
+ | English ๐Ÿ‡ฌ๐Ÿ‡ง | Sonia | Female | `en-GB-SoniaNeural` |
53
+ | English ๐Ÿ‡ฌ๐Ÿ‡ง | Ryan | Male | `en-GB-RyanNeural` |
54
+ | Arabic ๐Ÿ‡ธ๐Ÿ‡ฆ | Zariyah | Female | `ar-SA-ZariyahNeural` |
55
+ | Arabic ๐Ÿ‡ธ๐Ÿ‡ฆ | Hamed | Male | `ar-SA-HamedNeural` |
56
+ | French ๐Ÿ‡ซ๐Ÿ‡ท | Denise | Female | `fr-FR-DeniseNeural` |
57
+ | French ๐Ÿ‡ซ๐Ÿ‡ท | Henri | Male | `fr-FR-HenriNeural` |
58
+ | German ๐Ÿ‡ฉ๐Ÿ‡ช | Katja | Female | `de-DE-KatjaNeural` |
59
+ | German ๐Ÿ‡ฉ๐Ÿ‡ช | Conrad | Male | `de-DE-ConradNeural` |
60
+ | Italian ๐Ÿ‡ฎ๐Ÿ‡น | Elsa | Female | `it-IT-ElsaNeural` |
61
+ | Italian ๐Ÿ‡ฎ๐Ÿ‡น | Diego | Male | `it-IT-DiegoNeural` |
62
+ | Japanese ๐Ÿ‡ฏ๐Ÿ‡ต | Nanami | Female | `ja-JP-NanamiNeural` |
63
+ | Japanese ๐Ÿ‡ฏ๐Ÿ‡ต | Keita | Male | `ja-JP-KeitaNeural` |
64
+ | Korean ๐Ÿ‡ฐ๐Ÿ‡ท | Sun-Hi | Female | `ko-KR-SunHiNeural` |
65
+ | Korean ๐Ÿ‡ฐ๐Ÿ‡ท | InJoon | Male | `ko-KR-InJoonNeural` |
66
+ | Chinese (Simp.) ๐Ÿ‡จ๐Ÿ‡ณ | Xiaoxiao | Female | `zh-CN-XiaoxiaoNeural` |
67
+ | Chinese (Simp.) ๐Ÿ‡จ๐Ÿ‡ณ | Yunxi | Male | `zh-CN-YunxiNeural` |
68
+ | Chinese (Trad.) ๐Ÿ‡น๐Ÿ‡ผ| HsiaoChen| Female | `zh-TW-HsiaoChenNeural` |
69
+ | Chinese (Trad.) ๐Ÿ‡น๐Ÿ‡ผ| YunJhe | Male | `zh-TW-YunJheNeural` |
70
+
71
+ ## Technical Flow ๐Ÿ”ง
72
+ ```mermaid
73
+ sequenceDiagram
74
+ User->>+Gradio App: Select Language & Voice
75
+ User->>+Gradio App: Input Text
76
+ Gradio App->>+edge-tts: Send Request
77
+ edge-tts-->>-Gradio App: Return Audio
78
+ Gradio App->>+User: Play Audio
79
+ ````
80
+
81
+ ## Local Development ๐Ÿ’ป
82
+
83
+ ```bash
84
+ # Clone the repository
85
+ git clone [https://huggingface.co/spaces/snackshell/selam-tts](https://huggingface.co/spaces/snackshell/selam-tts)
86
+ cd selam-tts
87
+
88
+ # Install dependencies
89
+ pip install -r requirements.txt
90
+
91
+ # Run the app
92
+ python app.py
93
+ ```
94
+
95
+ ## Acknowledgments ๐Ÿ™
96
+
97
+ - Voice Technology: Microsoft Edge TTS
98
+ - Hosting: Hugging Face Spaces
99
+ - UI Framework: Gradio
100
+ - Maintained by: [Bana Codes](https://t.me/banacodes)
101
+
102
+ [๐Ÿ› Report Issues](https://github.com/snackshell/eng-amh-tts/issues)
103
+
104
+ ```
105
+ ```