Skip to content
Switch branches/tags

Multi-Speaker Tacotron in TensorFlow

[한국어 가이드]

TensorFlow implementation of:

Samples audios (in Korean) can be found here.




1. Install prerequisites

After preparing Tensorflow, install prerequisites with:

pip3 install -r requirements.txt
python -c "import nltk;'punkt')"

If you want to synthesize a speech in Korean dicrectly, follow 2-3. Download pre-trained models.

2-1. Generate custom datasets

The datasets directory should look like:

├── jtbc
│   ├── alignment.json
│   └── audio
│       ├── 1.mp3
│       ├── 2.mp3
│       ├── 3.mp3
│       └── ...
    ├── alignment.json
    └── audio
        ├── 1.mp3
        ├── 2.mp3
        ├── 3.mp3
        └── ...

and YOUR_DATASET/alignment.json should look like:

    "./datasets/YOUR_DATASET/audio/001.mp3": "My name is Taehoon Kim.",
    "./datasets/YOUR_DATASET/audio/002.mp3": "The buses aren't the problem.",
    "./datasets/YOUR_DATASET/audio/003.mp3": "They have discovered a new particle.",

After you prepare as described, you should genearte preprocessed data with:

python3 -m datasets.generate_data ./datasets/YOUR_DATASET/alignment.json

2-2. Generate Korean datasets

You can generate datasets for 3 public Korean figures including:

  1. Sohn Suk-hee: anchor and president of JTBC
  2. Park Geun-hye: a former President of South Korea
  3. Moon Jae-in: the current President of South Korea

Each dataset can be generated with following scripts:

./scripts/ # Sohn Suk-hee
./scripts/ # Park Geun-hye
./scripts/ # Moon Jae-in

Each script execute below commands. (explain with son dataset)

  1. To automate an alignment between sounds and texts, prepare GOOGLE_APPLICATION_CREDENTIALS to use Google Speech Recognition API. To get credentials, read this.

  2. Download speech(or video) and text.

    python3 -m
  3. Segment all audios on silence.

    python3 -m audio.silence --audio_pattern "./datasets/son/audio/*.wav" --method=pydub
  4. By using Google Speech Recognition API, we predict sentences for all segmented audios. (this is optional for moon and park because they already have recognition.json)

    python3 -m --audio_pattern "./datasets/son/audio/*.*.wav"
  5. By comparing original text and recognised text, save audio<->text pair information into ./datasets/son/alignment.json.

    python3 -m recognition.alignment --recognition_path "./datasets/son/recognition.json" --score_threshold=0.5
  6. Finally, generated numpy files which will be used in training.

    python3 -m datasets.generate_data ./datasets/son/alignment.json

Because the automatic generation is extremely naive, the dataset is noisy. However, if you have enough datasets (20+ hours with random initialization or 5+ hours with pretrained model initialization), you can expect an acceptable quality of audio synthesis.

2-3. Download pre-trained models

You can download a pre-trained models or generate audio. Available models are:

  1. Single speaker model for Sohn Suk-hee.

    python3 son
  2. Single speaker model for Park Geun-hye.

    python3 park

After you donwload pre-trained models, you can generate voices as follows:

python3 --load_path logs/son-20171015 --text "Is this real?"
python3 --load_path logs/park-20171015 --text "Is this real?"

WARNING: The two pre-trained models are being made available for research purpose only.

3. Train a model

The important hyperparameters for a models are defined in

(Change cleaners in from korean_cleaners to english_cleaners to train with English dataset)

To train a single-speaker model:

python3 --data_path=datasets/jtbc
python3 --data_path=datasets/park --initialize_path=PATH_TO_CHECKPOINT

To train a multi-speaker model:

# after change `model_type` in `` to `deepvoice` or `simple`
python3 --data_path=datasets/jtbc,datasets/park

To restart a training from previous experiments such as logs/son-20171015:

python3 --data_path=datasets/son --load_path logs/son-20171015

If you don't have good and enough (10+ hours) dataset, it would be better to use --initialize_path to use a well-trained model as initial parameters.

4. Synthesize audio

You can train your own models with:

python3 --load_path logs/park-20171015 --num_speakers=1

or generate audio directly with:

python3 --load_path logs/park-20171015 --text "이거 실화냐?"


This is not an official DEVSISTERS product. This project is not responsible for misuse or for any damage that you may cause. You agree that you use this software at your own risk.



Taehoon Kim / @carpedm20


Multi-speaker Tacotron in TensorFlow. 오픈소스 딥러닝 다중 화자 음성 합성 엔진.




No releases published


No packages published