mimic3/mimic3-http
2022-03-31 17:12:59 -04:00
..
img More README goodness 2022-03-31 16:50:28 -04:00
mimic3_http Add GET and POST apis to swagger 2022-03-31 17:12:49 -04:00
.gitignore Clean up HTTP server 2022-03-25 16:57:06 -04:00
.isort.cfg Initial commit 2022-03-16 17:22:15 -04:00
.projectile Initial commit 2022-03-16 17:22:15 -04:00
check.sh Use base venv 2022-03-31 11:27:53 -04:00
client.sh speechd-dispatcher example 2022-03-22 15:45:36 -04:00
LICENSE Clean up HTTP server 2022-03-25 16:57:06 -04:00
MANIFEST.in Add OpenAPI page 2022-03-31 15:46:10 -04:00
mypy.ini Clean up HTTP server 2022-03-25 16:57:06 -04:00
pylintrc Clean up HTTP server 2022-03-25 16:57:06 -04:00
README.md README clean up 2022-03-31 17:12:59 -04:00
requirements.txt Add OpenAPI page 2022-03-31 15:46:10 -04:00
run.sh Adjust shell scripts to use root of repo 2022-03-30 14:45:12 -04:00
setup.cfg Clean up HTTP server 2022-03-25 16:57:06 -04:00
setup.py Add OpenAPI page 2022-03-31 15:46:10 -04:00

Mimic 3 Web Server

A small HTTP web server for the Mimic 3 text to speech system.

Available voices

screenshot of web interface

Running the Server

mimic3-server

This will start a web server at http://localhost:59125

See mimic3-server --debug for more options.

Endpoints

  • /api/tts
    • POST text or SSML and receive WAV audio back
    • Use ?voice= to select a different voice/speaker
    • Set Content-Type to application/ssml+xml (or use ?ssml=1) for SSML input
  • /api/voices
    • Returns a JSON list of available voices

An OpenAPI test page is also available at http://localhost:59125/openapi

Running the Client

Assuming you have started mimic3-server and can access http://localhost:59125, then:

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

See mimic3-client --help for more options.

MaryTTS Compatibility

Use the Mimic 3 web server as a drop-in replacement for MaryTTS, for example with Home Assistant.

Make sure to use a compatible voice key like en_UK/apope_low.