speechkitty 0.1.5

A wrapper for Yandex SpeechKit API to asyncronously transcribe audio records.

SpeechKitty

SpeechKitty is a wrapper for Yandex SpeechKit API to asyncronously transcribe audio records.

NOTE

It's very initial version of the package. It works perfectly in my case with Asterisk records, but it's not tested in other use cases and with other records so you may want to wait for version 0.2 to try it.

Key features:

1. Scans directory recursively for wav files.
2. Applies regex mask to include and exclude certain files.
3. Skips already transcribed files.
4. Does all intermediate work like converting and uploading audio files to object storage.
5. Transcribes and puts json and html files into directory next to audio files.
6. Can obfuscate html files' names using hash.

Usage

You can use it as a package or a docker container.

Prerequisites

• Yandex Cloud account.
• Bucket at Object Storage.
• Static access key for Object Storage.
• API key for SpeechKit.

Python Package

0. Install required ffmpeg library.

1. Create venv (preferably) and install package.

pip install speechkitty

3. Download scripts from sample directory at project page:

• credentials-example.ini — rename to credentials.ini
• transcribe_directory.py

4. Fill credentials into credentials.ini

5. Start transcribing a directory (/mnt/Records in the example below):

export $(grep = credentials.ini | xargs)

python transcribe_directory.py /mnt/Records

Docker Container

0. Install Docker.

1. Download project's code from project page on GitHub.

2. Retrieve credentials from Yandex Cloud and put them into credentials.ini file.

3. Build docker image. For that open project directory in terminal then type:

docker build -t speechkitty .

Building image may take a while. After it finishes:

4. Run container. Assuming you have records in /mnt/Records and/or its subdirectories, current directory in terminal is project's directory, and you have credentials.ini file in the sample directory, the command will look like:

grep = sample/credentials.ini > sample/credentials.txt

docker run -i --rm --env-file sample/credentials.txt -v /mnt/Records:/mnt/Records \
speechkitty /bin/bash -c "python sample/transcribe_directory.py /mnt/Records"

Or you can use shell script:

source sample/transcribe_directory.sh /mnt/Records

To name html files using hash of the audio files names, add hash function as a second parameter like that:

source sample/transcribe_directory.sh /mnt/Records md5

This can be useful if records directory is being published using a web server (with option preventing directory listing, of course) and you don't want to reveal names of audio files to prevent files from being downloaded via direct link. So you can put something like SELECT CONCAT(TO_HEX(MD5(recordingfile)), ".html") AS transcript into the DB view to get names of the html files.

Transcribing job may take a while. A good sign that indicates it's working is an appearance of some new json and html files in records directory.