speechmatics-python provides a reference client for interfacing with version 2 of the Speechmatics Realtime ASR API. A command line interface is also provided for convenience.

• Make sure that you are running Python 3.7 or greater and install the dependencies

  $ python3 --version
  $ pip install git+https://github.com/speechmatics/speechmatics-python

• View the help message to make sure everything has been installed and setup

  $ speechmatics --help
  usage: speechmatics [-h] [-v] {transcribe} ...
  
  CLI for Speechmatics products.
  
  optional arguments:
    -h, --help    show this help message and exit
    -v            Set the log level for verbose logs. The number of flags
                  indicate the level, eg. -v is INFO and -vv is DEBUG.
  
  Commands:
    {transcribe}
      transcribe  Transcribe one or more audio file(s)

• A normal real time session using a .wav file as the input audio

  $ URL=wss://realtimeappliance.mycompany.io:9000/v2
  $ speechmatics transcribe--url $URL --lang en --ssl-mode=insecure example_audio.wav

• Show the messages that are going over the websocket connection

  $ URL=wss://realtimeappliance.mycompany.io:9000/v2
  $ speechmatics transcribe -v --url $URL --lang en --ssl-mode=insecure example_audio.wav

• Similar to the first example, but this time the input audio is piped in

  $ URL=wss://realtimeappliance.mycompany.io:9000/v2
  $ cat example_audio.wav | speechmatics transcribe --ssl-mode=insecure --url $URL --lang en -

• The CLI also accepts an audio stream on standard input, meaning that you can stream in a live microphone feed for example. This example requires ffmpeg. You may need to replace the ":0" according to the numbering of your input devices. You may also need to change the sample rate to match your machine's recording sample rate.

  Mac OS

  $ URL=wss://realtimeappliance.mycompanyio:9000/v2
  $ ffmpeg -loglevel quiet -f avfoundation -i ":0" -f f32le -c:a pcm_f32le - | speechmatics transcribe --ssl-mode=insecure --url $URL --raw pcm_f32le --sample-rate 44100 --lang en -

See the API Reference for the latest release at https://speechmatics.github.io/speechmatics-python/.

To install development dependencies and run tests

$ pip install -r requirements-dev.txt
$ make test

If you have any issues with this library or encounter any bugs then please get in touch with us at support@speechmatics.com.

License: MIT