1SpeechRecognition 2================= 3 4.. image:: https://img.shields.io/pypi/v/SpeechRecognition.svg 5 :target: https://pypi.python.org/pypi/SpeechRecognition/ 6 :alt: Latest Version 7 8.. image:: https://img.shields.io/pypi/status/SpeechRecognition.svg 9 :target: https://pypi.python.org/pypi/SpeechRecognition/ 10 :alt: Development Status 11 12.. image:: https://img.shields.io/pypi/pyversions/SpeechRecognition.svg 13 :target: https://pypi.python.org/pypi/SpeechRecognition/ 14 :alt: Supported Python Versions 15 16.. image:: https://img.shields.io/pypi/l/SpeechRecognition.svg 17 :target: https://pypi.python.org/pypi/SpeechRecognition/ 18 :alt: License 19 20.. image:: https://api.travis-ci.org/Uberi/speech_recognition.svg?branch=master 21 :target: https://travis-ci.org/Uberi/speech_recognition 22 :alt: Continuous Integration Test Results 23 24Library for performing speech recognition, with support for several engines and APIs, online and offline. 25 26Speech recognition engine/API support: 27 28* `CMU Sphinx <http://cmusphinx.sourceforge.net/wiki/>`__ (works offline) 29* Google Speech Recognition 30* `Google Cloud Speech API <https://cloud.google.com/speech/>`__ 31* `Wit.ai <https://wit.ai/>`__ 32* `Microsoft Bing Voice Recognition <https://www.microsoft.com/cognitive-services/en-us/speech-api>`__ 33* `Houndify API <https://houndify.com/>`__ 34* `IBM Speech to Text <http://www.ibm.com/smarterplanet/us/en/ibmwatson/developercloud/speech-to-text.html>`__ 35* `Snowboy Hotword Detection <https://snowboy.kitt.ai/>`__ (works offline) 36 37**Quickstart:** ``pip install SpeechRecognition``. See the "Installing" section for more details. 38 39To quickly try it out, run ``python -m speech_recognition`` after installing. 40 41Project links: 42 43- `PyPI <https://pypi.python.org/pypi/SpeechRecognition/>`__ 44- `Source code <https://github.com/Uberi/speech_recognition>`__ 45- `Issue tracker <https://github.com/Uberi/speech_recognition/issues>`__ 46 47Library Reference 48----------------- 49 50The `library reference <https://github.com/Uberi/speech_recognition/blob/master/reference/library-reference.rst>`__ documents every publicly accessible object in the library. This document is also included under ``reference/library-reference.rst``. 51 52See `Notes on using PocketSphinx <https://github.com/Uberi/speech_recognition/blob/master/reference/pocketsphinx.rst>`__ for information about installing languages, compiling PocketSphinx, and building language packs from online resources. This document is also included under ``reference/pocketsphinx.rst``. 53 54Examples 55-------- 56 57See the ``examples/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/examples>`__ in the repository root for usage examples: 58 59- `Recognize speech input from the microphone <https://github.com/Uberi/speech_recognition/blob/master/examples/microphone_recognition.py>`__ 60- `Transcribe an audio file <https://github.com/Uberi/speech_recognition/blob/master/examples/audio_transcribe.py>`__ 61- `Save audio data to an audio file <https://github.com/Uberi/speech_recognition/blob/master/examples/write_audio.py>`__ 62- `Show extended recognition results <https://github.com/Uberi/speech_recognition/blob/master/examples/extended_results.py>`__ 63- `Calibrate the recognizer energy threshold for ambient noise levels <https://github.com/Uberi/speech_recognition/blob/master/examples/calibrate_energy_threshold.py>`__ (see ``recognizer_instance.energy_threshold`` for details) 64- `Listening to a microphone in the background <https://github.com/Uberi/speech_recognition/blob/master/examples/background_listening.py>`__ 65- `Various other useful recognizer features <https://github.com/Uberi/speech_recognition/blob/master/examples/special_recognizer_features.py>`__ 66 67Installing 68---------- 69 70First, make sure you have all the requirements listed in the "Requirements" section. 71 72The easiest way to install this is using ``pip install SpeechRecognition``. 73 74Otherwise, download the source distribution from `PyPI <https://pypi.python.org/pypi/SpeechRecognition/>`__, and extract the archive. 75 76In the folder, run ``python setup.py install``. 77 78Requirements 79------------ 80 81To use all of the functionality of the library, you should have: 82 83* **Python** 2.6, 2.7, or 3.3+ (required) 84* **PyAudio** 0.2.11+ (required only if you need to use microphone input, ``Microphone``) 85* **PocketSphinx** (required only if you need to use the Sphinx recognizer, ``recognizer_instance.recognize_sphinx``) 86* **Google API Client Library for Python** (required only if you need to use the Google Cloud Speech API, ``recognizer_instance.recognize_google_cloud``) 87* **FLAC encoder** (required only if the system is not x86-based Windows/Linux/OS X) 88 89The following requirements are optional, but can improve or extend functionality in some situations: 90 91* On Python 2, and only on Python 2, some functions (like ``recognizer_instance.recognize_bing``) will run slower if you do not have **Monotonic for Python 2** installed. 92* If using CMU Sphinx, you may want to `install additional language packs <https://github.com/Uberi/speech_recognition/blob/master/reference/pocketsphinx.rst#installing-other-languages>`__ to support languages like International French or Mandarin Chinese. 93 94The following sections go over the details of each requirement. 95 96Python 97~~~~~~ 98 99The first software requirement is `Python 2.6, 2.7, or Python 3.3+ <https://www.python.org/download/releases/>`__. This is required to use the library. 100 101PyAudio (for microphone users) 102~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 103 104`PyAudio <http://people.csail.mit.edu/hubert/pyaudio/#downloads>`__ is required if and only if you want to use microphone input (``Microphone``). PyAudio version 0.2.11+ is required, as earlier versions have known memory management bugs when recording from microphones in certain situations. 105 106If not installed, everything in the library will still work, except attempting to instantiate a ``Microphone`` object will raise an ``AttributeError``. 107 108The installation instructions on the PyAudio website are quite good - for convenience, they are summarized below: 109 110* On Windows, install PyAudio using `Pip <https://pip.readthedocs.org/>`__: execute ``pip install pyaudio`` in a terminal. 111* On Debian-derived Linux distributions (like Ubuntu and Mint), install PyAudio using `APT <https://wiki.debian.org/Apt>`__: execute ``sudo apt-get install python-pyaudio python3-pyaudio`` in a terminal. 112 * If the version in the repositories is too old, install the latest release using Pip: execute ``sudo apt-get install portaudio19-dev python-all-dev python3-all-dev && sudo pip install pyaudio`` (replace ``pip`` with ``pip3`` if using Python 3). 113* On OS X, install PortAudio using `Homebrew <http://brew.sh/>`__: ``brew install portaudio``. Then, install PyAudio using `Pip <https://pip.readthedocs.org/>`__: ``pip install pyaudio``. 114* On other POSIX-based systems, install the ``portaudio19-dev`` and ``python-all-dev`` (or ``python3-all-dev`` if using Python 3) packages (or their closest equivalents) using a package manager of your choice, and then install PyAudio using `Pip <https://pip.readthedocs.org/>`__: ``pip install pyaudio`` (replace ``pip`` with ``pip3`` if using Python 3). 115 116PyAudio `wheel packages <https://pypi.python.org/pypi/wheel>`__ for common 64-bit Python versions on Windows and Linux are included for convenience, under the ``third-party/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/third-party>`__ in the repository root. To install, simply run ``pip install wheel`` followed by ``pip install ./third-party/WHEEL_FILENAME`` (replace ``pip`` with ``pip3`` if using Python 3) in the repository `root directory <https://github.com/Uberi/speech_recognition>`__. 117 118PocketSphinx-Python (for Sphinx users) 119~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 120 121`PocketSphinx-Python <https://github.com/bambocher/pocketsphinx-python>`__ is **required if and only if you want to use the Sphinx recognizer** (``recognizer_instance.recognize_sphinx``). 122 123PocketSphinx-Python `wheel packages <https://pypi.python.org/pypi/wheel>`__ for 64-bit Python 2.7, 3.4, and 3.5 on Windows are included for convenience, under the ``third-party/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/third-party>`__. To install, simply run ``pip install wheel`` followed by ``pip install ./third-party/WHEEL_FILENAME`` (replace ``pip`` with ``pip3`` if using Python 3) in the SpeechRecognition folder. 124 125On Linux and other POSIX systems (such as OS X), follow the instructions under "Building PocketSphinx-Python from source" in `Notes on using PocketSphinx <https://github.com/Uberi/speech_recognition/blob/master/reference/pocketsphinx.rst>`__ for installation instructions. 126 127Note that the versions available in most package repositories are outdated and will not work with the bundled language data. Using the bundled wheel packages or building from source is recommended. 128 129See `Notes on using PocketSphinx <https://github.com/Uberi/speech_recognition/blob/master/reference/pocketsphinx.rst>`__ for information about installing languages, compiling PocketSphinx, and building language packs from online resources. This document is also included under ``reference/pocketsphinx.rst``. 130 131Google API Client Library for Python (for Google Cloud Speech API users) 132~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 133 134`Google API Client Library for Python <https://developers.google.com/api-client-library/python/>`__ is required if and only if you want to use the Google Cloud Speech API (``recognizer_instance.recognize_google_cloud``). 135 136If not installed, everything in the library will still work, except calling ``recognizer_instance.recognize_google_cloud`` will raise an ``RequestError``. 137 138According to the `official installation instructions <https://developers.google.com/api-client-library/python/start/installation>`__, the recommended way to install this is using `Pip <https://pip.readthedocs.org/>`__: execute ``pip install google-api-python-client`` (replace ``pip`` with ``pip3`` if using Python 3). 139 140Alternatively, you can perform the installation completely offline from the source archives under the ``./third-party/Source code for Google API Client Library for Python and its dependencies/`` directory. 141 142FLAC (for some systems) 143~~~~~~~~~~~~~~~~~~~~~~~ 144 145A `FLAC encoder <https://xiph.org/flac/>`__ is required to encode the audio data to send to the API. If using Windows (x86 or x86-64), OS X (Intel Macs only, OS X 10.6 or higher), or Linux (x86 or x86-64), this is **already bundled with this library - you do not need to install anything**. 146 147Otherwise, ensure that you have the ``flac`` command line tool, which is often available through the system package manager. For example, this would usually be ``sudo apt-get install flac`` on Debian-derivatives, or ``brew install flac`` on OS X with Homebrew. 148 149Monotonic for Python 2 (for faster operations in some functions on Python 2) 150~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 151 152On Python 2, and only on Python 2, if you do not install the `Monotonic for Python 2 <https://github.com/atdt/monotonic>`__ library, some functions will run slower than they otherwise could (though everything will still work correctly). 153 154On Python 3, that library's functionality is built into the Python standard library, which makes it unnecessary. 155 156This is because monotonic time is necessary to handle cache expiry properly in the face of system time changes and other time-related issues. If monotonic time functionality is not available, then things like access token requests will not be cached. 157 158To install, use `Pip <https://pip.readthedocs.org/>`__: execute ``pip install monotonic`` in a terminal. 159 160Troubleshooting 161--------------- 162 163The recognizer tries to recognize speech even when I'm not speaking, or after I'm done speaking. 164~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 165 166Try increasing the ``recognizer_instance.energy_threshold`` property. This is basically how sensitive the recognizer is to when recognition should start. Higher values mean that it will be less sensitive, which is useful if you are in a loud room. 167 168This value depends entirely on your microphone or audio data. There is no one-size-fits-all value, but good values typically range from 50 to 4000. 169 170Also, check on your microphone volume settings. If it is too sensitive, the microphone may be picking up a lot of ambient noise. If it is too insensitive, the microphone may be rejecting speech as just noise. 171 172The recognizer can't recognize speech right after it starts listening for the first time. 173~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 174 175The ``recognizer_instance.energy_threshold`` property is probably set to a value that is too high to start off with, and then being adjusted lower automatically by dynamic energy threshold adjustment. Before it is at a good level, the energy threshold is so high that speech is just considered ambient noise. 176 177The solution is to decrease this threshold, or call ``recognizer_instance.adjust_for_ambient_noise`` beforehand, which will set the threshold to a good value automatically. 178 179The recognizer doesn't understand my particular language/dialect. 180~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 181 182Try setting the recognition language to your language/dialect. To do this, see the documentation for ``recognizer_instance.recognize_sphinx``, ``recognizer_instance.recognize_google``, ``recognizer_instance.recognize_wit``, ``recognizer_instance.recognize_bing``, ``recognizer_instance.recognize_api``, ``recognizer_instance.recognize_houndify``, and ``recognizer_instance.recognize_ibm``. 183 184For example, if your language/dialect is British English, it is better to use ``"en-GB"`` as the language rather than ``"en-US"``. 185 186The recognizer hangs on ``recognizer_instance.listen``; specifically, when it's calling ``Microphone.MicrophoneStream.read``. 187~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 188 189This usually happens when you're using a Raspberry Pi board, which doesn't have audio input capabilities by itself. This causes the default microphone used by PyAudio to simply block when we try to read it. If you happen to be using a Raspberry Pi, you'll need a USB sound card (or USB microphone). 190 191Once you do this, change all instances of ``Microphone()`` to ``Microphone(device_index=MICROPHONE_INDEX)``, where ``MICROPHONE_INDEX`` is the hardware-specific index of the microphone. 192 193To figure out what the value of ``MICROPHONE_INDEX`` should be, run the following code: 194 195.. code:: python 196 197 import speech_recognition as sr 198 for index, name in enumerate(sr.Microphone.list_microphone_names()): 199 print("Microphone with name \"{1}\" found for `Microphone(device_index={0})`".format(index, name)) 200 201This will print out something like the following: 202 203:: 204 205 Microphone with name "HDA Intel HDMI: 0 (hw:0,3)" found for `Microphone(device_index=0)` 206 Microphone with name "HDA Intel HDMI: 1 (hw:0,7)" found for `Microphone(device_index=1)` 207 Microphone with name "HDA Intel HDMI: 2 (hw:0,8)" found for `Microphone(device_index=2)` 208 Microphone with name "Blue Snowball: USB Audio (hw:1,0)" found for `Microphone(device_index=3)` 209 Microphone with name "hdmi" found for `Microphone(device_index=4)` 210 Microphone with name "pulse" found for `Microphone(device_index=5)` 211 Microphone with name "default" found for `Microphone(device_index=6)` 212 213Now, to use the Snowball microphone, you would change ``Microphone()`` to ``Microphone(device_index=3)``. 214 215Calling ``Microphone()`` gives the error ``IOError: No Default Input Device Available``. 216~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 217 218As the error says, the program doesn't know which microphone to use. 219 220To proceed, either use ``Microphone(device_index=MICROPHONE_INDEX, ...)`` instead of ``Microphone(...)``, or set a default microphone in your OS. You can obtain possible values of ``MICROPHONE_INDEX`` using the code in the troubleshooting entry right above this one. 221 222The code examples raise ``UnicodeEncodeError: 'ascii' codec can't encode character`` when run. 223~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 224 225When you're using Python 2, and your language uses non-ASCII characters, and the terminal or file-like object you're printing to only supports ASCII, an error is raised when trying to write non-ASCII characters. 226 227This is because in Python 2, ``recognizer_instance.recognize_sphinx``, ``recognizer_instance.recognize_google``, ``recognizer_instance.recognize_wit``, ``recognizer_instance.recognize_bing``, ``recognizer_instance.recognize_api``, ``recognizer_instance.recognize_houndify``, and ``recognizer_instance.recognize_ibm`` return unicode strings (``u"something"``) rather than byte strings (``"something"``). In Python 3, all strings are unicode strings. 228 229To make printing of unicode strings work in Python 2 as well, replace all print statements in your code of the following form: 230 231 .. code:: python 232 233 print SOME_UNICODE_STRING 234 235With the following: 236 237 .. code:: python 238 239 print SOME_UNICODE_STRING.encode("utf8") 240 241This change, however, will prevent the code from working in Python 3. 242 243The program doesn't run when compiled with `PyInstaller <https://github.com/pyinstaller/pyinstaller/wiki>`__. 244~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 245 246As of PyInstaller version 3.0, SpeechRecognition is supported out of the box. If you're getting weird issues when compiling your program using PyInstaller, simply update PyInstaller. 247 248You can easily do this by running ``pip install --upgrade pyinstaller``. 249 250On Ubuntu/Debian, I get annoying output in the terminal saying things like "bt_audio_service_open: [...] Connection refused" and various others. 251~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 252 253The "bt_audio_service_open" error means that you have a Bluetooth audio device, but as a physical device is not currently connected, we can't actually use it - if you're not using a Bluetooth microphone, then this can be safely ignored. If you are, and audio isn't working, then double check to make sure your microphone is actually connected. There does not seem to be a simple way to disable these messages. 254 255For errors of the form "ALSA lib [...] Unknown PCM", see `this StackOverflow answer <http://stackoverflow.com/questions/7088672/pyaudio-working-but-spits-out-error-messages-each-time>`__. Basically, to get rid of an error of the form "Unknown PCM cards.pcm.rear", simply comment out ``pcm.rear cards.pcm.rear`` in ``/usr/share/alsa/alsa.conf``, ``~/.asoundrc``, and ``/etc/asound.conf``. 256 257For "jack server is not running or cannot be started" or "connect(2) call to /dev/shm/jack-1000/default/jack_0 failed (err=No such file or directory)" or "attempt to connect to server failed", these are caused by ALSA trying to connect to JACK, and can be safely ignored. I'm not aware of any simple way to turn those messages off at this time, besides [entirely disabling printing while starting the microphone](https://github.com/Uberi/speech_recognition/issues/182#issuecomment-266256337). 258 259On OS X, I get a ``ChildProcessError`` saying that it couldn't find the system FLAC converter, even though it's installed. 260~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ 261 262Installing `FLAC for OS X <https://xiph.org/flac/download.html>`__ directly from the source code will not work, since it doesn't correctly add the executables to the search path. 263 264Installing FLAC using `Homebrew <http://brew.sh/>`__ ensures that the search path is correctly updated. First, ensure you have Homebrew, then run ``brew install flac`` to install the necessary files. 265 266Developing 267---------- 268 269To hack on this library, first make sure you have all the requirements listed in the "Requirements" section. 270 271- Most of the library code lives in ``speech_recognition/__init__.py``. 272- Examples live under the ``examples/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/examples>`__, and the demo script lives in ``speech_recognition/__main__.py``. 273- The FLAC encoder binaries are in the ``speech_recognition/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/speech_recognition>`__. 274- Documentation can be found in the ``reference/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/reference>`__. 275- Third-party libraries, utilities, and reference material are in the ``third-party/`` `directory <https://github.com/Uberi/speech_recognition/tree/master/third-party>`__. 276 277To install/reinstall the library locally, run ``python setup.py install`` in the project `root directory <https://github.com/Uberi/speech_recognition>`__. 278 279Before a release, the version number is bumped in ``README.rst`` and ``speech_recognition/__init__.py``. Version tags are then created using ``git config gpg.program gpg2 && git config user.signingkey DB45F6C431DE7C2DCD99FF7904882258A4063489 && git tag -s VERSION_GOES_HERE -m "Version VERSION_GOES_HERE"``. 280 281Releases are done by running ``make-release.sh`` to build the Python source packages, sign them, and upload them to PyPI. 282 283Testing 284~~~~~~~ 285 286To run all the tests: 287 288.. code:: bash 289 290 python -m unittest discover --verbose 291 292Testing is also done automatically by TravisCI, upon every push. To set up the environment for offline/local Travis-like testing on a Debian-like system: 293 294.. code:: bash 295 296 sudo docker run --volume "$(pwd):/speech_recognition" --interactive --tty quay.io/travisci/travis-python:latest /bin/bash 297 su - travis && cd /speech_recognition 298 sudo apt-get update && sudo apt-get install swig libpulse-dev 299 pip install --user pocketsphinx monotonic && pip install --user flake8 rstcheck && pip install --user -e . 300 python -m unittest discover --verbose # run unit tests 301 python -m flake8 --ignore=E501,E701 speech_recognition tests examples setup.py # ignore errors for long lines and multi-statement lines 302 python -m rstcheck README.rst reference/*.rst # ensure RST is well-formed 303 304FLAC Executables 305~~~~~~~~~~~~~~~~ 306 307The included ``flac-win32`` executable is the `official FLAC 1.3.2 32-bit Windows binary <http://downloads.xiph.org/releases/flac/flac-1.3.2-win.zip>`__. 308 309The included ``flac-linux-x86`` and ``flac-linux-x86_64`` executables are built from the `FLAC 1.3.2 source code <http://downloads.xiph.org/releases/flac/flac-1.3.2.tar.xz>`__ with `Manylinux <https://github.com/pypa/manylinux>`__ to ensure that it's compatible with a wide variety of distributions. 310 311The built FLAC executables should be bit-for-bit reproducible. To rebuild them, run the following inside the project directory on a Debian-like system: 312 313.. code:: bash 314 315 # download and extract the FLAC source code 316 cd third-party 317 sudo apt-get install --yes docker.io 318 319 # build FLAC inside the Manylinux i686 Docker image 320 tar xf flac-1.3.2.tar.xz 321 sudo docker run --tty --interactive --rm --volume "$(pwd):/root" quay.io/pypa/manylinux1_i686:latest bash 322 cd /root/flac-1.3.2 323 ./configure LDFLAGS=-static # compiler flags to make a static build 324 make 325 exit 326 cp flac-1.3.2/src/flac/flac ../speech_recognition/flac-linux-x86 && sudo rm -rf flac-1.3.2/ 327 328 # build FLAC inside the Manylinux x86_64 Docker image 329 tar xf flac-1.3.2.tar.xz 330 sudo docker run --tty --interactive --rm --volume "$(pwd):/root" quay.io/pypa/manylinux1_x86_64:latest bash 331 cd /root/flac-1.3.2 332 ./configure LDFLAGS=-static # compiler flags to make a static build 333 make 334 exit 335 cp flac-1.3.2/src/flac/flac ../speech_recognition/flac-linux-x86_64 && sudo rm -r flac-1.3.2/ 336 337The included ``flac-mac`` executable is extracted from `xACT 2.39 <http://xact.scottcbrown.org/>`__, which is a frontend for FLAC 1.3.2 that conveniently includes binaries for all of its encoders. Specifically, it is a copy of ``xACT 2.39/xACT.app/Contents/Resources/flac`` in ``xACT2.39.zip``. 338 339Authors 340------- 341 342:: 343 344 Uberi <me@anthonyz.ca> (Anthony Zhang) 345 bobsayshilol 346 arvindch <achembarpu@gmail.com> (Arvind Chembarpu) 347 kevinismith <kevin_i_smith@yahoo.com> (Kevin Smith) 348 haas85 349 DelightRun <changxu.mail@gmail.com> 350 maverickagm 351 kamushadenes <kamushadenes@hyadesinc.com> (Kamus Hadenes) 352 sbraden <braden.sarah@gmail.com> (Sarah Braden) 353 tb0hdan (Bohdan Turkynewych) 354 Thynix <steve@asksteved.com> (Steve Dougherty) 355 beeedy <broderick.carlin@gmail.com> (Broderick Carlin) 356 357Please report bugs and suggestions at the `issue tracker <https://github.com/Uberi/speech_recognition/issues>`__! 358 359How to cite this library (APA style): 360 361 Zhang, A. (2017). Speech Recognition (Version 3.8) [Software]. Available from https://github.com/Uberi/speech_recognition#readme. 362 363How to cite this library (Chicago style): 364 365 Zhang, Anthony. 2017. *Speech Recognition* (version 3.8). 366 367Also check out the `Python Baidu Yuyin API <https://github.com/DelightRun/PyBaiduYuyin>`__, which is based on an older version of this project, and adds support for `Baidu Yuyin <http://yuyin.baidu.com/>`__. Note that Baidu Yuyin is only available inside China. 368 369License 370------- 371 372Copyright 2014-2017 `Anthony Zhang (Uberi) <http://anthonyz.ca/>`__. The source code for this library is available online at `GitHub <https://github.com/Uberi/speech_recognition>`__. 373 374SpeechRecognition is made available under the 3-clause BSD license. See ``LICENSE.txt`` in the project's `root directory <https://github.com/Uberi/speech_recognition>`__ for more information. 375 376For convenience, all the official distributions of SpeechRecognition already include a copy of the necessary copyright notices and licenses. In your project, you can simply **say that licensing information for SpeechRecognition can be found within the SpeechRecognition README, and make sure SpeechRecognition is visible to users if they wish to see it**. 377 378SpeechRecognition distributes source code, binaries, and language files from `CMU Sphinx <http://cmusphinx.sourceforge.net/>`__. These files are BSD-licensed and redistributable as long as copyright notices are correctly retained. See ``speech_recognition/pocketsphinx-data/*/LICENSE*.txt`` and ``third-party/LICENSE-Sphinx.txt`` for license details for individual parts. 379 380SpeechRecognition distributes source code and binaries from `PyAudio <http://people.csail.mit.edu/hubert/pyaudio/>`__. These files are MIT-licensed and redistributable as long as copyright notices are correctly retained. See ``third-party/LICENSE-PyAudio.txt`` for license details. 381 382SpeechRecognition distributes binaries from `FLAC <https://xiph.org/flac/>`__ - ``speech_recognition/flac-win32.exe``, ``speech_recognition/flac-linux-x86``, and ``speech_recognition/flac-mac``. These files are GPLv2-licensed and redistributable, as long as the terms of the GPL are satisfied. The FLAC binaries are an `aggregate <https://www.gnu.org/licenses/gpl-faq.html#MereAggregation>`__ of `separate programs <https://www.gnu.org/licenses/gpl-faq.html#NFUseGPLPlugins>`__, so these GPL restrictions do not apply to the library or your programs that use the library, only to FLAC itself. See ``LICENSE-FLAC.txt`` for license details. 383