Skip to content

Highly Pythonic module implementing speech recognition using the Google Speech Recognition API.

License

Notifications You must be signed in to change notification settings

bobsayshilol/speech_recognition

 
 

Repository files navigation

Google Speech Recognition

Library for performing speech recognition with the Google Speech Recognition API.

Links:

Quickstart: pip install SpeechRecognition

Examples

Recognize speech input from the microphone:

                                               # NOTE: this requires PyAudio because it uses the Microphone class
import speech_recognition as sr
r = sr.Recognizer()
with sr.Microphone() as source:                # use the default microphone as the audio source
    audio = r.listen(source)                   # listen for the first phrase and extract it into audio data

try:
    print("You said " + r.recognize(audio))    # recognize speech using Google Speech Recognition
except LookupError:                            # speech is unintelligible
    print("Could not understand audio")

Transcribe a WAV audio file:

import speech_recognition as sr
r = sr.Recognizer()
with sr.WavFile("test.wav") as source:              # use "test.wav" as the audio source
    audio = r.record(source)                        # extract audio data from the file

try:
    print("Transcription: " + r.recognize(audio))   # recognize speech using Google Speech Recognition
except LookupError:                                 # speech is unintelligible
    print("Could not understand audio")

Transcribe a WAV audio file and show the confidence of each:

import speech_recognition as sr
r = sr.Recognizer()
with sr.WavFile("test.wav") as source:              # use "test.wav" as the audio source
    audio = r.record(source,True)                   # extract audio data from the file

try:
    list = r.recognize(audio,True)                  # generate a list of possible transcriptions
    print("Possible transcriptions:")
    for prediction in list:
        print(" " + prediction["text"] + " (" + str(prediction["confidence"]*100) + "%)")
except LookupError:                                 # speech is unintelligible
    print("Could not understand audio")

Installing

The easiest way to install this is using pip install SpeechRecognition.

Otherwise, download the source distribution from PyPI, and extract the archive.

In the folder, run python setup.py install.

Reference

Microphone(device_index = None)

This is available if PyAudio is available, and is undefined otherwise.

Creates a new Microphone instance, which represents a physical microphone on the computer. Subclass of AudioSource.

If device_index is unspecified or None, the default microphone is used as the audio source. Otherwise, device_index should be the index of the device to use for audio input.

A device index is an integer between 0 and pyaudio.get_device_count() - 1 (assume we have used import pyaudio beforehand) inclusive. It represents an audio device such as a microphone or speaker. See the PyAudio documentation for more details.

This class is to be used with with statements:

with Microphone() as source:    # open the microphone and start recording
    pass                        # do things here - `source` is the Microphone instance created above
                                # the microphone is automatically released at this point

WavFile(filename_or_fileobject)

Creates a new WavFile instance, which represents a WAV audio file. Subclass of AudioSource.

If filename_or_fileobject is a string, then it is interpreted as a path to a WAV audio file on the filesystem. Otherwise, filename_or_fileobject should be a file-like object such as io.BytesIO or similar. In either case, the specified file is used as the audio source.

This class is to be used with with statements:

with WavFile("test.wav") as source:    # open the WAV file for reading
    pass                               # do things here - `source` is the WavFile instance created above

Recognizer(language = "en-US", key = "AIzaSyBOti4mM-6x9WDnZIjIeyEU21OpBXqWBgw")

Creates a new Recognizer instance, which represents a collection of speech recognition functionality.

The language is determined by language, a standard language code, and defaults to US English.

key is your unique Speech API key generated by following these instructions: http://www.chromium.org/developers/how-tos/api-keys

recognizer_instance.energy_threshold = 100

Represents the energy level threshold for sounds. Values below this threshold are considered silence. Can be changed.

This threshold is associated with the perceived loudness of the sound, but it is a nonlinear relationship. Typical values for a silent room are 0 to 1, and typical values for speaking are between 150 and 3500.

recognizer_instance.pause_threshold = 0.8

Represents the minimum length of silence (in seconds) that will register as the end of a phrase. Can be changed.

Smaller values result in the recognition completing more quickly, but might result in slower speakers being cut off.

recognizer_instance.record(source, duration = None)

Records up to duration seconds of audio from source (an AudioSource instance) into an AudioData instance, which it returns.

If duration is not specified, then it will record until there is no more audio input.

recognizer_instance.listen(source, timeout = None)

Records a single phrase from source (an AudioSource instance) into an AudioData instance, which it returns.

This is done by waiting until the audio has an energy above recognizer_instance.energy_threshold (the user has started speaking), and then recording until it encounters recognizer_instance.pause_threshold seconds of silence or there is no more audio input. The ending silence is not included.

recognizer_instance.recognize(audio_data, show_all=False)

Performs speech recognition, using the Google Speech Recognition API, on audio_data (an AudioData instance).

Returns the most likely transcription if show_all is False, otherwise it returns a dict of all possible transcriptions and their confidence levels.

Note: confidence is set to 0 if it isn't given by Google

Also raises a LookupError exception if the speech is unintelligible, or a KeyError if the key isn't valid or the quota for the key has been maxed out.

Note: KeyError is a subclass of LookupError so a LookupError will catch both. To catch a KeyError you must place it before LookupError eg:

import speech_recognition as sr
r = sr.Recognizer()
with sr.WavFile("test.wav") as source:              # use "test.wav" as the audio source
    audio = r.record(source)                        # extract audio data from the file

try:
    print("You said " + r.recognize(audio))         # recognize speech using Google Speech Recognition
except KeyError:                                    # the API key didn't work
    print("Invalid API key or quota maxed out")
except LookupError:                                 # speech is unintelligible
    print("Could not understand audio")

AudioSource

Base class representing audio sources. Do not instantiate.

Instances of subclasses of this class, such as Microphone and WavFile, can be passed to things like recognizer_instance.record and recognizer_instance.listen.

AudioData

Storage class for audio data.

Contains the fields rate and data, which represent the framerate and raw audio samples of the audio data, respectively.

Requirements

Google Speech API v2 now requires a key.

A generic key is provided, but it is advised you create your by following these steps: http://www.chromium.org/developers/how-tos/api-keys

The first requirement is Python 3.3 or better. This is required to use the library.

Additionally, it must be 32-bit Python if you are using the included PyAudio binaries. It is also technically possible though inconvenient to compile PyAudio for 64-bit Python.

If you want to use the Microphone class (necessary for recording from microphone input), PyAudio is also necessary. If not installed, the library will still work, but Microphone will be undefined.

The official PyAudio builds seem to be broken on Windows. As a result, in the installers folder you will find unofficial builds for Windows that actually work. Run installers/PyAudio-0.2.7.win32-py3.3.exe for Python 3.3 and PyAudio-0.2.7.win32-py3.4.exe for Python 3.4.

A FLAC encoder is required to encode the audio data to send to the API. If using Windows or Linux, the encoder is already bundled with this library. Otherwise, ensure that you have the flac command line tool, which is often available through one's system package manager.

License

Copyright 2014 Anthony Zhang azhang9@gmail.com (Uberi).

The source code is available online at GitHub.

This program is made available under the 3-clause BSD license. See LICENSE.txt for more information.

About

Highly Pythonic module implementing speech recognition using the Google Speech Recognition API.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 99.5%
  • Shell 0.5%