MLLP_Streaming_API/README.md

MLLP Streaming API example

This repository contains some examples of client code to use the MLLP Streaming Speech Recognition API

Setup and installation

Streaming API example, tested in Ubuntu 16.04 and Python3.6

System dependencies:

sudo apt install libasound-dev portaudio19-dev libportaudio2 libportaudiocpp0 ffmpeg libav-tools

Installation

#Prepare virtual environment
virtualenv env --python=/path/to/python3.6 env

#Activate environment
source env/bin/activate

#Install requirements
pip install -r requirements.txt

#Download & Install Streaming client library
wget https://ttp.mllp.upv.es/mllp-streaming-api/MLLPStreamingClient_mllp-1.0.0-py3-none-any.whl
pip install MLLPStreamingClient_mllp-1.0.0-py3-none-any.whl

Examples

Replace this lines in the examples with your credentials and server information:

server_hostname = "<SERVER_ADDRESS>"
server_port = "<PORT>"
api_user = "<YOU_API_USER>"
api_secret = "<YOUR_API_KEY>"
server_ssl_cert_file = "<CRT_FILE>"

To get the server SSL cert, use this commands:

apt-get install openssl
echo -n | openssl s_client -connect ttp.mllp.upv.es:443 | sed -ne '/-BEGIN CERTIFICATE-/,/-END CERTIFICATE-/p' > ttp.mllp.upv.es.crt

To run the examples:

#Activate the environment
sourve env/bin/activate

#Sending WAV file
python3 python_examples/client.short.wav.py wav_example/AAFA0016.wav

#Sending audio from mic
python3 python_examples/client.mic.py

Detailed documentation (login required):

• Streaming service API (login required)
• Python API client

Contact and support

mail: mllp-support@upv.es