LibreAI / Audio / WaveRNN
// audio · fatchord/WaveRNN

WaveRNN

WaveRNN vocoder plus Tacotron TTS in PyTorch: train your own neural speech synthesis on LJSpeech.

★ 2.2k stars⑂ 685 forksMITupdated 2022-07
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

WaveRNN is an open-source audio project by fatchord (fatchord/WaveRNN on GitHub). It has 2,191 GitHub stars and 685 forks, is released under the MIT license, and was last updated on GitHub on 2 July 2022.

GitHub stars
2,191
Forks
685
License
MIT
Last updated on GitHub
2 July 2022
Category
Audio
Listing
Full install guide
Official site
Official site
// how it works

How it works

  1. Clarify your goal

    Decide whether you want instant TTS from the pretrained models or to train on your own voice dataset.

  2. Get the project

    Clone the repository and install the requirements with pip, with PyTorch and CUDA available.

  3. Install and configure

    For training, download the LJSpeech dataset, point the hyperparameters at your wav path, and run preprocessing.

  4. Run your first task

    Generate speech with the quick start script, or train Tacotron and then WaveRNN following the documented order.

// features

Why people love it

Complete TTS pipeline

Combines a Tacotron acoustic model with the WaveRNN vocoder so text goes in and waveform audio comes out.

Pretrained models included

A WaveRNN model (mixture-of-logistics output) and a Tacotron model, both trained on LJSpeech, live in the pretrained folder.

Quick start generation

quick_start.py synthesises the default sentences, accepts custom input text, and can run unbatched for better audio quality, saving wavs and attention plots.

Documented training order

Preprocess, train Tacotron, optionally force a GTA dataset mid-training, train WaveRNN with or without GTA, then generate.

Configurable hyperparameters

Dataset paths and training settings are centralised in hparams.py for easy adaptation to other corpora.

Audio samples published

A samples page linked from the README lets you hear output quality before installing anything.

Advertisement
// run it

Run it yourself

  1. Clone and install requirements

    Make sure PyTorch 1 with CUDA is installed first, per the README.

    git clone https://github.com/fatchord/WaveRNN.git
    cd WaveRNN
    pip install -r requirements.txt
  2. Quick start with pretrained models

    Generate the default sentences into a quick_start output folder.

    python quick_start.py
  3. Generate custom sentences

    Pass your own text, optionally unbatched for higher quality.

    python quick_start.py -u --input_text "What will happen if I run this command?"
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains it?

It is maintained by fatchord, building on the WaveRNN and Tacotron papers and earlier open implementations credited in the README.

Is it free to use?

Yes, it is MIT-licensed, including use of the bundled pretrained models.

Does it need a paid API key?

No. Everything runs locally in PyTorch; there are no hosted APIs or keys.

How does it compare to a well-known alternative?

HiFi-GAN is a GAN vocoder focused on mel inversion; WaveRNN pairs its autoregressive vocoder with a full Tacotron TTS front end and its own training pipeline in one repo.

How do I get started?

Clone the repo, pip install -r requirements.txt, and run python quick_start.py to hear the pretrained system immediately.

// keep exploring

Similar tools

Audio

Mozilla TTS

Mozilla's deep-learning text-to-speech library with Tacotron, Glow-TTS and neural vocoders.

★ 10.2k starsMPL-2.0
View guide →
Audio

vall-e

Unofficial PyTorch implementation of VALL-E, the neural codec language model for zero-shot TTS

★ 3.0k starsMIT
View guide →
Audio

speechbrain

A PyTorch-based Speech Toolkit

★ 11.9k starsApache-2.0
View guide →
Audio

pyttsx3

Offline text-to-speech for Python — uses your operating system's own voices, no internet needed

★ 2.5k starsMPL-2.0
View guide →
Audio

kokoro-tts

Turn books and documents into natural speech with the Kokoro TTS model.

★ 1.9k starsMIT
View guide →
Audio

Coqui TTS

Deep learning toolkit for text-to-speech, battle-tested in research and production

★ 46.1k starsMPL-2.0
View guide →
// alternatives

Alternatives in Audio

The most-starred other Audio projects in the LibreAI catalogue — the realistic shortlist if WaveRNN is not the right fit.

Get WaveRNN

Free and open — grab the source, star the repo, and start creating.