https://github.com/pythainlp/pythaitts
Open Source Thai Text-to-speech library in Python
https://github.com/pythainlp/pythaitts
hacktoberfest speech-synthesis tts
Last synced: 2 months ago
JSON representation
Open Source Thai Text-to-speech library in Python
- Host: GitHub
- URL: https://github.com/pythainlp/pythaitts
- Owner: PyThaiNLP
- License: apache-2.0
- Created: 2022-08-11T07:59:21.000Z (over 3 years ago)
- Default Branch: dev
- Last Pushed: 2026-01-15T18:58:04.000Z (3 months ago)
- Last Synced: 2026-01-15T20:55:39.377Z (3 months ago)
- Topics: hacktoberfest, speech-synthesis, tts
- Language: Jupyter Notebook
- Homepage: https://pythainlp.github.io/PyThaiTTS/
- Size: 3.78 MB
- Stars: 51
- Watchers: 2
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# PyThaiTTS
Open Source Thai Text-to-speech library in Python
[Google Colab](https://colab.research.google.com/github/PyThaiNLP/PyThaiTTS/blob/dev/notebook/use_lunarlist_model.ipynb) | [Docs](https://pythainlp.github.io/PyThaiTTS/) | [Notebooks](https://github.com/PyThaiNLP/PyThaiTTS/tree/dev/notebook)
License: [Apache-2.0 License](https://github.com/PyThaiNLP/pythaitts/blob/main/LICENSE)
## Install
Install by pip:
> pip install pythaitts
## Usage
### Basic Usage
```python
from pythaitts import TTS
tts = TTS()
file = tts.tts("ภาษาไทย ง่าย มาก มาก", filename="cat.wav") # It will get wav file path.
wave = tts.tts("ภาษาไทย ง่าย มาก มาก",return_type="waveform") # It will get waveform.
```
### Using Different TTS Models
PyThaiTTS supports multiple TTS models. You can specify which model to use:
```python
from pythaitts import TTS
# Use VachanaTTS (default voices: th_f_1, th_m_1, th_f_2, th_m_2)
tts = TTS(pretrained="vachana")
file = tts.tts("สวัสดีครับ", speaker_idx="th_f_1", filename="output.wav")
# Use Lunarlist ONNX (default)
tts = TTS(pretrained="lunarlist_onnx")
file = tts.tts("ภาษาไทย ง่าย มาก", filename="output.wav")
# Use KhanomTan
tts = TTS(pretrained="khanomtan")
file = tts.tts("ภาษาไทย", speaker_idx="Linda", filename="output.wav")
```
### Text Preprocessing
PyThaiTTS includes automatic text preprocessing to improve TTS quality:
- **Number to Thai text conversion**: Converts digits (e.g., "123") to Thai text (e.g., "หนึ่งร้อยยี่สิบสาม")
- **Mai yamok (ๆ) expansion**: Expands the Thai repetition character (e.g., "ดีๆ" becomes "ดีดี")
Preprocessing is enabled by default:
```python
from pythaitts import TTS
tts = TTS()
# Automatic preprocessing: "มี 5 คนๆ" becomes "มี ห้า คนคน"
file = tts.tts("มี 5 คนๆ", filename="output.wav")
```
You can disable preprocessing if needed:
```python
file = tts.tts("มี 5 คนๆ", preprocess=False, filename="output.wav")
```
You can also use preprocessing functions directly:
```python
from pythaitts import num_to_thai, expand_maiyamok, preprocess_text
# Convert numbers to Thai text
print(num_to_thai("123")) # Output: หนึ่งร้อยยี่สิบสาม
# Expand mai yamok
print(expand_maiyamok("ดีๆ")) # Output: ดีดี
# Full preprocessing
print(preprocess_text("มี 5 คนๆ")) # Output: มี ห้า คนคน
```
You can see more at [https://pythainlp.github.io/PyThaiTTS/](https://pythainlp.github.io/PyThaiTTS/).