A native client for running queries on an exported DeepSpeech model.
Create a symbolic link in the TensorFlow checkout to the deepspeech native_client directory.
cd tensorflow
ln -s ../DeepSpeech/native_client ./
Before building the DeepSpeech client libraries, you will need to prepare your environment to configure and build TensorFlow. Follow the instructions on the TensorFlow site for your platform, up to the end of 'Configure the installation'.
Then you can build the Tensorflow and DeepSpeech libraries.
bazel build -c opt --copt=-march=native --copt=-mtune=native --copt=-O3 //tensorflow:libtensorflow_cc.so //native_client:*
Finally, you can change to the native_client directory and use the Makefile. By default, the Makefile will assume there is a TensorFlow checkout in a directory above the DeepSpeech checkout. If that is not the case, set the environment variable TFDIR to point to the right directory.
cd ../DeepSpeech/native_client
make deepspeech
After building, the library files and binary can optionally be installed to a system path for ease of development. This is also a required step for bindings generation.
PREFIX=/usr/local sudo make install
It is assumed that $PREFIX/lib is a valid library path, otherwise you may need to alter your environment.
The client can be run via the Makefile. The client will accept audio of any format your installation of SoX supports.
ARGS="/path/to/output_graph.pb /path/to/audio/file.ogg" make run
Included are a set of generated Python bindings. After following the above build and installation instructions, these can be installed by executing the following commands (or equivalent on your system):
make bindings
sudo pip install dist/deepspeech*
The API mirrors the C++ API and is demonstrated in client.py. Refer to deepspeech.h for documentation.