tts-cache

Cache TTS voices from Google Cloud Text-To-Speech.

The app can store audios for an arbitrary amount of time (default 1 year). A monthly characters limit can be used to prevent exceeding resource quotas. The quotas are managed locally, without properly checking the actual resource usage.

Built with minio and FastAPI.

Easy deployment with Docker Compose.

Local development

Create a .env file with the following properties

MINIO_URL="127.0.0.1:9000"
MINIO_ACCESS_KEY=REPLACEME
MINIO_SECRET_KEY=REPLACEME

Create a config.json file with the following structure

{
  "gcp_counter_limit": 500000,
  "languages": {
    "de": {
      "gcp_language": "de-DE",
      "gcp_voice_name": "de-DE-Wavenet-D"
    }
  },
  "google_application_credentials": "/path/to/google/application/credentials.json",
  "audio_expiry": 365
}

Languages can be enabled by adding an entry in languages with appropriate gcp_language and gcp_voice_name fields.

Create a folder /mnt/minio and start minio with this command

docker run -p 9000:9000 \
    -e "MINIO_ACCESS_KEY=REPLACEME" \
    -e "MINIO_SECRET_KEY=REPLACEME" \
    -v /mnt/minio:/data \
    minio/minio server /data

You can interact with the minio web interface at http://127.0.0.1:9000/minio/

Launch the FastAPI server from the main directory with uvicorn

uvicorn --factory app.app:create_app --reload

or with Gunicorn

gunicorn -k uvicorn.workers.UvicornWorker "app.app:create_app()"

Docker Compose deployment

Create a .env.docker file with the following properties

MINIO_URL=minio:9000
MINIO_ACCESS_KEY=REPLACEME
MINIO_SECRET_KEY=REPLACEME

Create a config_docker.json file with the following structure

{
  "gcp_counter_limit": 500000,
  "languages": {
    "de": {
      "gcp_language": "de-DE",
      "gcp_voice_name": "de-DE-Wavenet-D"
    }
  },
  "google_application_credentials": "/run/secrets/google_json",
  "audio_expiry": 365
}

Languages can be enabled by adding an entry in languages with appropriate gcp_language and gcp_voice_name fields.

Get your GCP credentials enabled to use the Text-To-Speech API, save them as a file and set their location (on the host machine) in the docker-compose.yml in the google_json secret.

Create a folder /mnt/minio or change the directory in the docker-compose.yml file to a directory of your choosing.

Start the app with

docker-compose up -d

The service will listen at port 22243 (cache in t9).