Coqui STT Playbook

A crash course on training speech recognition models using 🐸STT.


Start here. This section will set your expectations for what you can achieve with the STT Playbook, and the prerequisites you’ll need to start to train your own speech recognition models.

About Coqui STT

Once you know what you can achieve with the STT Playbook, this section provides an overview of STT itself, its component parts, and how it differs from other speech recognition engines you may have used in the past.

Formatting your training data

Before you can train a model, you will need to collect and format your corpus of data. This section provides an overview of the data format required for STT, and walks through an example in prepping a dataset from Common Voice.

The alphabet.txt file

If you are training a model that uses a different alphabet to English, for example a language with diacritical marks, then you will need to modify the alphabet.txt file.

Acoustic model and language model

Learn about the differences between STT’s acoustic model and language model and how they combine to provide end to end speech recognition.

Setting up your training environment

This section walks you through building a Docker image, and spawning STT in a Docker container with persistent storage. This approach avoids the complexities of dependencies such as tensorflow.

Training a model

Once you have your training data formatted, and your training environment established, this section will show you how to train a model, and provide guidance for overcoming common pitfalls.

Building your own scorer

Learn what the scorer does, and how you can go about building your own.

Testing a model

Once you’ve trained a model, you will need to validate that it works for the context it’s been designed for. This section walks you through this process.

Deploying your model

Once trained and tested, your model is deployed. This section provides an overview of how you can deploy your model.

Applying STT to real world problems

This section covers specific use cases where STT can be applied to real world problems, such as transcription, keyword searching and voice controlled applications.

Introductory courses on machine learning

Providing an introduction to machine learning is beyond the scope of this PlayBook, howevever having an understanding of machine learning and deep learning concepts will aid your efforts in training speech recognition models with STT.

Here, we’ve linked to several resources that you may find helpful; they’re listed in the order we recommend reading them in.

How you can help provide feedback on the STT PlayBook

You can help to make the STT PlayBook even better by providing via a GitHub Issue

  • Please try these instructions, particularly for building a Docker image and running a Docker container, on multiple distributions of Linux so that we can identify corner cases.

  • Please contribute your tacit knowledge - such as:

    • common errors encountered in data formatting, environment setup, training and validation

    • techniques or approaches for improving the scorer, alphabet file or the accuracy of Word Error Rate (WER) and Character Error Rate (CER).

    • case studies of the work you or your organisation have been doing, showing your approaches to data validation, training or evaluation.

  • Please identify errors in text - with many eyes, bugs are shallow :-)