jyapayne/mimic3
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
A fast local neural text to speech engine for Mycroft
37 commits 1 branch 0 tags 2.1 MiB
Find a file
Michael Hansen 33ea9c086d Updating READMEs
2022-03-31 13:17:25 -04:00
docker Add mimic3-client script 2022-03-31 12:23:14 -04:00
mimic3-http Updating READMEs 2022-03-31 13:17:25 -04:00
mimic3-tts Updating READMEs 2022-03-31 13:17:25 -04:00
opentts-abc Working single-file binary build 2022-03-30 17:08:56 -04:00
pyinstaller Working single-file binary build 2022-03-30 17:08:56 -04:00
.dockerignore Working single-file binary build 2022-03-30 17:08:56 -04:00
.gitignore Extend gitignore 2022-03-30 14:46:20 -04:00
.projectile Initial commit 2022-03-16 17:22:15 -04:00
Dockerfile Working single-file binary build 2022-03-30 17:08:56 -04:00
Dockerfile.binary Don't use --onefile in PyInstaller, it's too slow on the Pi 2022-03-30 18:14:18 -04:00
install.sh Updating READMEs 2022-03-31 13:17:25 -04:00
LICENSE Fix license 2022-03-25 16:57:31 -04:00
Makefile Don't use --onefile in PyInstaller, it's too slow on the Pi 2022-03-30 18:14:18 -04:00
README.md Updating READMEs 2022-03-31 13:17:25 -04:00
requirements_dev.txt Working single-file binary build 2022-03-30 17:08:56 -04:00

README.md

Mimic 3

A fast and local neural text to speech system for Mycroft and the Mark II.

Available voices

Dependencies

Mimic 3 requires:

Installation

eSpeak

Some voices depend on eSpeak-ng, specifically libespeak-ng.so. For those voices, make sure that libespeak-ng is installed with:

sudo apt-get install libespeak-ng1

Mycroft TTS Plugin

Install the plugin:

mycroft-pip install plugin-tts-mimic3[all]

Enable the plugin in your mycroft.conf file:

mycroft-conf set tts.module mimic3_tts_plug

See the plugin's documentation for more options.

Using pip

Install the command-line tool:

pip install mimic3[all]

Once installed, the following commands will be available: * mimic3 * mimic3-download

Install the HTTP web server:

pip install mimic3-http[all]

Once installed, the following commands will be available: * mimic3-server * mimic3-client

Language support can be selectively installed by replacing all with:

  • de - German
  • es - Spanish
  • fr - French
  • it - Italian
  • nl - Dutch
  • ru - Russian
  • sw - Kiswahili

Excluding [..] entirely will install support for English only.

From Source

Clone the repository:

git clone https://github.com/MycroftAI/mimic3.git

Run the install script:

cd mimic3/
./install.sh

A virtual environment will be created in mimic3/.venv and each of the Python modules will be installed in editiable mode (pip install -e).

Once installed, the following commands will be available in .venv/bin: * mimic3 * mimic3-server * mimic3-client * mimic3-download

Voice Keys

Mimic 3 references voices with the format:

  • <language>/<name>_<quality> for single speaker voices, and
  • <language>/<name>_<quality>#<speaker> for multi-speaker voices
    • <speaker> can be a name or number starting at 0
    • Speaker names come from a voice's speakers.txt file

For example, the default Alan Pope voice key is en_UK/apope_low. The CMU Arctic voice contains multiple speakers, with a commonly used voice being en_US/cmu-arctic_low#slt.

Voices are automatically downloaded from Github and stored in ${HOME}/.local/share/mimic3

Running

Command-Line Tools

The mimic3 command can be used to synthesize audio on the command line:

mimic3 --voice 'en_UK/apope_low' 'My hovercraft is full of eels.' > hovercraft_eels.wav

See voice keys for how to reference voices and speakers.

See mimic3 --help or the CLI documentation for more details.

Web Server and Client

SSML

A subset of SSML is supported.

License

See license file