speechrecognition

SpeechRecognition 3.16.0 is out🎉
This release adds Cohere Transcribe API support.
Get all of these updates with a quick pip install --upgrade SpeechRecognition.
Enjoy!

What's Changed

Features

• feat: Add Cohere Transcribe API support (recognize_cohere_api) by @ftnext in #889

Improvements

• unittest workflow improvements (#890, #891)

Full Changelog: 3.15.2...3.16.0

SpeechRecognition 3.15.2 is out🎉
This release focuses on GitHub Actions improvements.
Get all of these updates with a quick pip install --upgrade SpeechRecognition.
Enjoy!

What's Changed

Improvements

• chore: Secure GitHub Actions specifier by @ftnext in #883
• ci: Try actions/stale only for needinfo issues in #887
• docs: Extract CONTRIBUTING in #886
  • docs: About AI-generated contributions in #885

Full Changelog: 3.15.1...3.15.2

SpeechRecognition 3.15.1 is out🎉
This release focuses on packaging bugfixes.
Get all of these updates with a quick pip install --upgrade SpeechRecognition.
Enjoy!

What's Changed

Improvements

• pyproject.toml improvements
  • fix: remove tests from wheel by @marmitar in #878
  • license metadata in #879 & package data in #880 by @ftnext
• docs: Add Code Wiki badge by @ftnext in #870

New Contributors

• @marmitar made their first contribution in #878

Thanks! 👏

Full Changelog: 3.15.0...3.15.1

SpeechRecognition 3.15.0 is out🎉
This release focuses on packaging and distribution improvements, making installs more reliable and modernizing the project configuration.
Get all of these updates with a quick pip install --upgrade SpeechRecognition.
Enjoy!

What's Changed

Improvements

• chore: Migrate the project to pyproject.toml by @ftnext in #877
  • chore: Make FLAC binaries executable in #876
  • fix: Exclude the models data directory from package discovery in #875

Full Changelog: 3.14.6...3.15.0

SpeechRecognition 3.14.6 was out🎉
This release mainly improves docs metadata, and also clarifies existing OpenAI-compatible endpoint support.
Get all of these and more with a quick pip install --upgrade SpeechRecognition.
Enjoy!

What's Changed

Improvements

• docs: OpenAI-compatible self-hosted endpoints are already supported by @ftnext in #863 (and #864, #865)
• Support docs integrations for both human and LLM
  • DeepWiki https://deepwiki.com/Uberi/speech_recognition (#868, #869)
  • Mintlify https://mintlify.com/Uberi/speech_recognition (#871)
  • context7 https://context7.com/uberi/speech_recognition (#872, #873, #874)

Full Changelog: 3.14.5...3.14.6

SpeechRecognition 3.14.5 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Improvements

• docs: Fix Groq API broken documentation URLs by @ftnext in https://github.com/Uberi/speech_recognition/pull/860
• chore: Run type check on GitHub Actions by @ftnext in https://github.com/Uberi/speech_recognition/pull/862
  • fix: make GroqOptionalParameters fields optional by @KorigamiK in https://github.com/Uberi/speech_recognition/pull/859
  • Small fixes of type hints in https://github.com/Uberi/speech_recognition/pull/861

New Contributors

• @KorigamiK made their first contribution in https://github.com/Uberi/speech_recognition/pull/859

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.14.4...3.14.5

SpeechRecognition 3.14.4 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Features

• Add verbose parameter to recognize_vosk() by @ftnext in https://github.com/Uberi/speech_recognition/pull/845
• feat: Download Vosk model with sprc download vosk by @ftnext in https://github.com/Uberi/speech_recognition/pull/846 & https://github.com/Uberi/speech_recognition/pull/847
• Add a blurb about Recall.ai by @Uberi

Bugfixes

• Include soundfile in faster-whisper extra by @Harmon758 in https://github.com/Uberi/speech_recognition/pull/856 (Thanks!)

Improvements

• docs: add additional type inference for consumers by @hamirmahal in https://github.com/Uberi/speech_recognition/pull/840 (Thanks!)
• Add test and refactor recognize_vosk() by @ftnext in https://github.com/Uberi/speech_recognition/pull/842 & https://github.com/Uberi/speech_recognition/pull/843

New Contributors

• @hamirmahal made their first contribution in https://github.com/Uberi/speech_recognition/pull/840
• @Harmon758 made their first contribution in https://github.com/Uberi/speech_recognition/pull/856

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.14.3...3.14.4

SpeechRecognition 3.14.3 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Improvements

• Fix vosk's URL model list broken link in error message by @sebampuero in https://github.com/Uberi/speech_recognition/pull/836
• refactor: Extract logic as AudioData.from_file() by @ftnext in https://github.com/Uberi/speech_recognition/pull/834
• Add --prompt & --verbose in python -m speech_recognition.recognizers.whisper_api.openai by @ftnext in https://github.com/Uberi/speech_recognition/pull/837

New Contributors

• @sebampuero made their first contribution in https://github.com/Uberi/speech_recognition/pull/836

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.14.2...3.14.3

SpeechRecognition 3.14.2 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Features

• Support gpt-4o-transcribe and gpt-4o-mini-transcribe (in whisper_api.openai recognizer) by @ftnext in https://github.com/Uberi/speech_recognition/pull/833

Improvements

• Tidy up third-party directory by @ftnext in https://github.com/Uberi/speech_recognition/pull/826

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.14.1...3.14.2

SpeechRecognition 3.14.1 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Improvements

• Support PocketSphinx >= 5
  • Fix PocketSphinx tests failure on ubuntu-24.04 by @ftnext in https://github.com/Uberi/speech_recognition/pull/823

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.14.0...3.14.1

SpeechRecognition 3.14.0 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Features

• Support Faster Whisper by @ftnext in https://github.com/Uberi/speech_recognition/pull/814

Improvements

• Refactor recognize_whisper() to support Whisper variants in future by @ftnext in https://github.com/Uberi/speech_recognition/pull/813
• Remove recognize_whisper_api (Use recognize_openai instead) by @ftnext in https://github.com/Uberi/speech_recognition/pull/815
• Make copyright year of license not need to update by @ftnext in https://github.com/Uberi/speech_recognition/pull/818

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.13.0...3.14.0

SpeechRecognition 3.13.0 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Improvement (Google Cloud Speech-to-Text API)

• Adds Parameter use_enhanced and model to GoogleCloudSpeech (Fix #734) by @HideyoshiNakazone in https://github.com/Uberi/speech_recognition/pull/735
• Refine google_cloud recognizer's parameters by @ftnext in https://github.com/Uberi/speech_recognition/pull/812
  • Introduce extra: pip install SpeechRecognition[google-cloud]
  • Delegate to google-auth (Deprecate passing credentials JSON) by @ftnext in https://github.com/Uberi/speech_recognition/pull/811
• Bugfixes
  • Remove trailing space by @ftnext in https://github.com/Uberi/speech_recognition/pull/810
  • Correct API parameters from CamelCase to snake_case

misc

• Use pipx to lint simpler and faster by @cclauss in https://github.com/Uberi/speech_recognition/pull/792
• Use pipx for lint and rstcheck by @ftnext in https://github.com/Uberi/speech_recognition/pull/807

New Contributors

• @HideyoshiNakazone made their first contribution in https://github.com/Uberi/speech_recognition/pull/735

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.12.0...3.13.0

SpeechRecognition 3.12.0 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

Groq Support

• recognizer_instance.recognize_groq() (@ftnext in https://github.com/Uberi/speech_recognition/pull/797 & https://github.com/Uberi/speech_recognition/pull/803)
  • Use with an environment variable GROQ_API_KEY
• Rename to recognizer_instance.recognize_openai() (Deprecate recognizer_instance.recognize_whisper_api()) (@ftnext in https://github.com/Uberi/speech_recognition/pull/801)
  • SpeechRecognition supports Whisper API served OpenAI and Groq
  • Use with an environment variable OPENAI_API_KEY
  • OpenAI's optional parameters partially supported (@ftnext in https://github.com/Uberi/speech_recognition/pull/802, Idea from @wronkiew https://github.com/Uberi/speech_recognition/pull/676)
• Decision: make the responsibility of checking environment variables each library (not SpeechRecognition) (@ftnext in https://github.com/Uberi/speech_recognition/pull/804)
  • export XXX_API_KEY=... or os.environ["XXX_API_KEY"] = ...

Python 3.13 Support (experimental)

• Install aifc and audioop in Python 3.13 by @ftnext in https://github.com/Uberi/speech_recognition/pull/781
• Run tests on Python 3.13 (excluding whisper-local) by @ftnext in https://github.com/Uberi/speech_recognition/pull/785

Improvement

Cleanup extras

• Tidy dependencies: requests by @ftnext in https://github.com/Uberi/speech_recognition/pull/780
• Extract pocketsphinx extra by @ftnext in https://github.com/Uberi/speech_recognition/pull/787

Others

• Install PyAudio in unittest Action by @ftnext in https://github.com/Uberi/speech_recognition/pull/774
• Adopt pytest by @ftnext in https://github.com/Uberi/speech_recognition/pull/779
• Fix "SetuptoolsDeprecationWarning: bdist_wheel.universal is deprecated" by @ftnext in https://github.com/Uberi/speech_recognition/pull/773

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.11.0...3.12.0

SpeechRecognition 3.11.0 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

• Add stream= kwarg to Recognizer.listen by @clusterfudge in https://github.com/Uberi/speech_recognition/pull/757

Improvements

• Support Python maintenance: Add 3.12, Drop 3.8 by @ftnext in https://github.com/Uberi/speech_recognition/pull/770
• Remove deprecated distutils @ftnext in https://github.com/Uberi/speech_recognition/pull/768 and https://github.com/Uberi/speech_recognition/pull/769
  • Support pip install SpeechRecognition[audio]

New Contributors

• @clusterfudge made their first contribution in https://github.com/Uberi/speech_recognition/pull/757

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.10.4...3.11.0

SpeechRecognition 3.10.4 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

• Support M1 Mac by @ftnext in https://github.com/Uberi/speech_recognition/pull/745
• Enable to pass SSL endpoint to cope with WinError 10054 by @ftnext in https://github.com/Uberi/speech_recognition/pull/754
  • Thanks to @Hexer-7 https://github.com/Uberi/speech_recognition/pull/751

Improvements

• Migrate from TravisCI by @ftnext in https://github.com/Uberi/speech_recognition/pull/741 https://github.com/Uberi/speech_recognition/pull/742
  • Fix code according to flake8
• Run unittests on Windows in CI by @ftnext in https://github.com/Uberi/speech_recognition/pull/746

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.10.3...3.10.4

SpeechRecognition 3.10.3 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Improvements

• Tweak installation by @ftnext in https://github.com/Uberi/speech_recognition/pull/740
  • Support pip install SpeechRecognition[whisper-local]
  • Support pip install SpeechRecognition[whisper-api]
• Add tests with mock by @ftnext (#738, #739)

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.10.2...3.10.3

SpeechRecognition 3.10.2 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

Bugfixes

• Updated to the latest OpenAI API changes, and fixed #720 by @herrjemand in https://github.com/Uberi/speech_recognition/pull/729

New Contributors

• @herrjemand made their first contribution in https://github.com/Uberi/speech_recognition/pull/729

Thanks to all contributors!

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.10.1...3.10.2

SpeechRecognition 3.10.1 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

• Support Python 3.11

Improvements

• Refactor recognize_google by @ftnext in https://github.com/Uberi/speech_recognition/pull/721

Thanks to all contributors!

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.10.0...3.10.1

SpeechRecognition 3.10.0 was out🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

• Support Whisper API by @ftnext in https://github.com/Uberi/speech_recognition/pull/669

Improvements

Thanks❤️

• Replace with in-memory stream on recognize_whisper by @ftnext in https://github.com/Uberi/speech_recognition/pull/647
• Remove prints that shouldn't be printed by default by @kuzmoyev in https://github.com/Uberi/speech_recognition/pull/651
• Codebase is under refactoring...

Deprecations

• Drop inactive Python by @ftnext in https://github.com/Uberi/speech_recognition/pull/650
  • SpeechRecognition currently supports Python 3.8+

New Contributors

• @kuzmoyev made their first contribution in https://github.com/Uberi/speech_recognition/pull/651

Thanks to all contributors!

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.9.0...3.10.0

SpeechRecognition 3.9.0 was out on December 2022🎉 Get all of these and more with a quick pip install --upgrade SpeechRecognition. Enjoy!

What's Changed

New features

Thanks for making SpeechRecognition even more wonderful! 🙌

• Add recognize_tensorflow by @chriamue in https://github.com/Uberi/speech_recognition/pull/296
• Add recognize_vosk by @mytja in https://github.com/Uberi/speech_recognition/pull/513
• Add recognize_amazon and recognize_assemblyai by @chrisspen in https://github.com/Uberi/speech_recognition/pull/434
• Add recognize_whisper by @joy-void-joy in https://github.com/Uberi/speech_recognition/pull/625

Bugfixes & improvements

Thanks!👏

• Update to speechContext formatting for recognize_google_cloud by @dcam0050 in https://github.com/Uberi/speech_recognition/pull/304
• Fix for OSError: [Errno -9988] Stream closed Error by @chriamue in https://github.com/Uberi/speech_recognition/pull/306
• Add paramater to change profanity filter level for Google Speech Recognition by @jorgegarciadev in https://github.com/Uberi/speech_recognition/pull/363
• Updating Wit API version (20160526 -> 20170307) by @Franck-Dernoncourt in https://github.com/Uberi/speech_recognition/pull/344
• Google cloud speech library by @frnsys in https://github.com/Uberi/speech_recognition/pull/406
• Fix large cpu consumption in snowboy detect by @Aculeasis in https://github.com/Uberi/speech_recognition/pull/395
• Replace Bing Speech API with Azure Speech API by @lastcoolnameleft in https://github.com/Uberi/speech_recognition/pull/389
• Removed duplicate code by @jhoelzl in https://github.com/Uberi/speech_recognition/pull/321
• fix recognize_google_cloud by @alinerguio in https://github.com/Uberi/speech_recognition/pull/601
• Pin pocketsphinx temporarily by @ftnext in https://github.com/Uberi/speech_recognition/pull/627
• Specify fp16 parameter for whisper by @ftnext in https://github.com/Uberi/speech_recognition/pull/630

Documentation improvements

Thanks!❤️

• Update pocketsphinx.rst by @fygul in https://github.com/Uberi/speech_recognition/pull/396
• docs: fix simple typo, covnert -> convert by @timgates42 in https://github.com/Uberi/speech_recognition/pull/536
• Update pocketsphinx.rst by @fygul in https://github.com/Uberi/speech_recognition/pull/435

Improvements for developers

• Fix Travis build by @native-api in https://github.com/Uberi/speech_recognition/pull/418 (Thanks!)
• Fix unit tests of recognize_google method by @ftnext in https://github.com/Uberi/speech_recognition/pull/619

New Contributors

• @dcam0050 made their first contribution in https://github.com/Uberi/speech_recognition/pull/304
• @chriamue made their first contribution in https://github.com/Uberi/speech_recognition/pull/296
• @jorgegarciadev made their first contribution in https://github.com/Uberi/speech_recognition/pull/363
• @Franck-Dernoncourt made their first contribution in https://github.com/Uberi/speech_recognition/pull/344
• @fygul made their first contribution in https://github.com/Uberi/speech_recognition/pull/396
• @frnsys made their first contribution in https://github.com/Uberi/speech_recognition/pull/406
• @Aculeasis made their first contribution in https://github.com/Uberi/speech_recognition/pull/395
• @lastcoolnameleft made their first contribution in https://github.com/Uberi/speech_recognition/pull/389
• @native-api made their first contribution in https://github.com/Uberi/speech_recognition/pull/418
• @mytja made their first contribution in https://github.com/Uberi/speech_recognition/pull/513
• @alinerguio made their first contribution in https://github.com/Uberi/speech_recognition/pull/601
• @chrisspen made their first contribution in https://github.com/Uberi/speech_recognition/pull/434
• @timgates42 made their first contribution in https://github.com/Uberi/speech_recognition/pull/536
• @joy-void-joy made their first contribution in https://github.com/Uberi/speech_recognition/pull/625

Thanks to all contributors!

Full Changelog: https://github.com/Uberi/speech_recognition/compare/3.8.1...3.9.0

Lots of changes since June! Summary below. Get all of these and more with a quick pip install --upgrade SpeechRecognition.

• Snowboy hotwords support for highly efficient, performant listening (thanks @beeedy!). This is implemented as the snowboy_configuration parameter of recognizer_instance.listen.
• Configurable Pocketsphinx models - you can now specify your own acoustic parameters, language model, and phoneme dictionary, using the language parameter of recognizer_instance.recognize_sphinx (thanks @frawau!).
• audio_data_instance.get_segment(start_ms=None, end_ms=None) is a new method that can be called on any AudioData instance to get a segment of the audio starting at start_ms and ending at end_ms. This is really useful when you want to get, say, only the first five seconds of some audio.
• The stopper function returned by listen_in_background now accepts one parameter, wait_for_stop (defaulting to True for backwards compatibility), which determines whether the function will wait for the background thread to fully shutdown before returning. One advantage is that if wait_for_stop is False, you can call the stopper function from any thread!
• New example, demonstrating how to simultaneously listen to and recognize speech with the threaded producer/consumer pattern: threaded_workers.py.
• Various improvements and bugfixes:
  • Python 3 style type annotations in library documentation.
  • recognize_google_cloud now uses the v1 rather than the beta API (thanks @oort7!).
  • recognize_google_cloud now returns timestamp info when the show_all parameter is True.
  • recognize_bing won't time out as often on credential requests, due to a longer default timeout.
  • recognize_google_cloud timeouts respect recognizer_instance.operation_timeout now (thanks @reefactor!).
  • Any recognizers using FLAC audio were broken inside Linux on Docker - this is now fixed (thanks @reefactor!).
  • Various documentation and lint fixes (thanks @josh-hernandez-exe!).
  • Lots of small build system improvements.

As usual, get it with pip install --upgrade SpeechRecognition

• New grammar parameter for recognizer_instance.recognize_sphinx - now, you can specify a JSGF or FSG grammar to PocketSphinx (thanks @aleneum!).
• Update PyAudio to version 0.2.11 - this fixes a couple memory management issues users have been experiencing.
• Update FLAC to 1.3.2 on all platforms - this will make it easier to support more audio formats in the near future.
• Fixes for various APIs on Python 3.6+ - small changes in urllib.request behavior made requests fail in certain situations.
• Fixes for Bing Speech API timing out due to some backwards incompatible changes to their API.
• Restore original IBM audio segmentation behaviour - previously, it would stop recognizing after the first pause. Now, it will recognize all speech in the input audio, as it did before IBM's changes.
• Fix links in PocketSphinx docs and library reference. Add-on language models now available from Google Drive, including the now-officially-supported Italian model.
• New troubleshooting entries for JACK server in README.
• Documentation and build process updates.

Quick bugfix for PortableNamedTemporaryFile:

• Fix file descriptor opening on Python 2.
• Add tests for Sphinx keyword matching.

Bugfix release!

• Fix tempfile.NamedTemporaryFile on Windows, by replacing it with a PortableNamedTemporaryFile class. Previously, it didn't necessarily support the file being re-opened after originally opened.
• Documentation/troubleshooting improvements (thanks @hassanmian!).
• Add support for 24-bit FLAC audio files (thanks @sudevschiz!).
• Fix phrase_time_limit being ignored for listen_in_background (thanks @dodysw!)
• Added lots of new audio regression tests.
• Code cleanup for tests and examples.

Small bugfix release:

• Handle case when GSR doesn't return a confidence value (thanks @jcsilva!).
• Config, style, and release improvements.
• Fix console window sometimes popping up when on Windows (thanks @Qdrew!)
• Switch release over to universal Wheels rather than source distribution.

This is more of a maintenance release, but a few features slipped in as well:

• Support for the Google Cloud Speech API with recognizer_instance.recognize_google_cloud (thanks @Thynix!), plus documentation and examples.
• Automatic sample rate detection in speech_recognition.Microphone - this should fully resolve all the "Invalid sample rate" issues from PyAudio.
• Project now has automated tests and continuous integration with TravisCI. It's pretty nifty, and has already caught a few things during development!
• Keywords example for recognizer_instance.recognize_sphinx.
• Documentation improvements and updated advice in troubleshooting and library reference.
• Bugfix - Google Speech Recognition sometimes didn't return the text with the highest confidence (thanks @akabraham!).
• Bugfix - EOFError upon encountering malformed audio files; a proper exception message is now given.
• Updated FLAC binaries for OS X.
• Bugfix - invalid FLAC binary path on OS X (thanks @akabraham!).
• Code cleanup.

• Support for the Houndify API with recognizer_instance.recognize_houndify (thanks @tb0hdan!).
• recognize_sphinx now supports keyword-based matching via the keywords=[("cat", 30), ("potato", 45)] parameter.
  • The second number in each pair is the sensitivity, which determines how loosely Sphinx will interpret speech to be those keywords - higher numbers mean more false positives, while lower numbers mean a lower detection rate.
  • A new example for keyword matching is now available.
• BREAKING CHANGE: API.AI STT API IS BEING SHUT DOWN SOON. (source)
  • For now, the recognize_api function will keep working if you're on a paid API.AI plan, and we will not be removing it until the service is shut down entirely.
  • It is best to transition to another backend as soon as possible. I recommend Microsoft Bing Voice Recognition or Wit.ai for previous API.AI users.
• phrase_time_limit option for listening functions, to limit phrase lengths to a certain number of seconds.
• Support for operation timeouts with recognizer_instance.operation_timeout - this can be used to ensure long requests always take finite time.
• recognize_ibm now opts out of request logging by default, for improved user privacy (thanks @michellemorales!). This is a breaking change if you previously relied on request logging behaviour.
• Bugfix - listen() sometimes didn't terminate on finite-length streams.
• Bugfix - Microsoft Bing Voice Recognition changed their authentication API endpoint, so that required some small code updates (thanks @tmator!).
• Bugfix - 24-bit audio now works correctly on Python 2.
• Update Wit.ai API version from deprecated version.
• A bunch of documentation updates, fixes, and improvements.

Bugfix release.

Changes:

• api.ai now requires the sessionId field, so we'll just add that in (thanks @jhoelzl!).
• Improve documentation a bit.
• Various other small fixes.

Changes:

• Bug fix: non-24-bit audio wasn't converted properly to 16-bit audio on Python 2, due to the new 24-bit audio shim. Thanks to @jhoelzl for reporting!

Maintenance release:

• Python versions less than 3.4 don't support 24-bit audio properly. We now have pure-Python shims that will allow 24-bit audio to work on those old Python versions, though they will be somewhat slower. Thanks to @danse for reporting the issue!
• Added updated Pocketsphinx binaries and Pocketsphinx installation procedures to match improvements on their end.
• Fix Unicode file paths on Windows.
• Fix caching in recognizer_instance.recognize_bing.
• We now use the Manylinux Docker image for building FLAC. Hopefully, this will make building universal Linux binaries easier for packagers.

Bugfix release:

• Thanks to @jhoelzl, api.ai language support works again for non-English languages.

We're now GPG signing all our release tags. Under the releases page, you should see the following:

This tells you that GitHub thinks the Git tag is the same as the one we intended to release.

This key can also be found on the SKS keyservers, and you can import it with the following command:

gpg --keyserver x-hkp://pool.sks-keyservers.net --recv-keys 0x5F56B350

The packages on PyPI are signed as well - the signature can be downloaded under the "pgp" link on the SpeechRecognition PyPI page.

Quick bugfix release on the tails of yesterday's big one:

• Add support for the monotonic library on Python 2 - if you have monotonic installed in Python 2, recognize_bing will work faster!
  • On Python 3, recognize_bing already does the things that would make it fast, so the library is unnecessary.
• Fix loading of non-16-bit AIFF files on Python 2.
• Better document the Pocketsphinx language pack installation.

Changes:

• BREAKING CHANGE: AT&T STT API IS BEING SHUT DOWN SOON. (source)
  • For now, the recognize_att function will keep working, until the API itself is shut down.
  • It is best to transition over to IBM, Wit.ai, Google, CMU Sphinx, Bing Voice, or api.ai as soon as possible.
  • In most cases, you can simply rename recognize_att to a different service like recognize_ibm, then generate new API keys/tokens for it.
• DEPRECATED CLASS: WavFile has been renamed to AudioFile.
  • WavFile will continue to work for the foreseeable future. New code should use AudioFile.
  • AudioFile is the same as WavFile, but in addition to WAV, it also supports AIFF and FLAC files!
• New api.ai support, courtesy of @sbraden! See recognize_api in the library reference.
• New Microsoft Bing Voice Recognition API support! See recognize_bing in the library reference.
• Support for 8-bit unsigned WAV audio (thanks to @zhaoqf123 for reporting!).
• Faster, upgraded FLAC binaries, with Linux binaries using Holy Build Box for maximum distro compatibility..
• Updated setup process for Wit.ai.
• Update phrase retrieval for recognize_ibm, courtesy of Bhavik Shah from IBM.
• Documentation improvements and code cleanup.
• Clearer licensing information - see the README.

As always, you can upgrade with pip install --upgrade speechrecognition.

Changes:

• Tiny fix to some error checking.
• The version number is all 3's now. This is pretty OK.

Bugfix release!

• Fix exception_on_overflow shenanigans. This version will eliminate those pesky ValueErrors.
• The overflow error should well and truly be gone now.

Special thanks to @michaelpri10 for reporting the exception_on_overflow bug.

Fix for list_microphone_names, courtesy of @ibutra. Fully compatible with 3.3.0.

See #85 for more details!

Major changes since 3.2.1:

• Possible backward incompatibility: if PyAudio is not installed, Microphone now throws an AttributeError when created rather than not being defined.
  • This only requires changes if you are explicitly testing for the existance of the class, using something like hasattr or getattr.
• More robust error handling - always clean up PyAudio resources, no matter what error conditions arise.
• Better error checking - always verify PyAudio version.

Changes since 3.2.0:

• Significantly improved and reorganized documentation.
• Fix for overflow issue, courtesy of @jbwincek.

Major changes since 3.1.3:

• Support for recognition using CMU Sphinx - do speech recognition while offline!
  • English supported out of the box; French and Mandarin available for download. See the README for details.
• Automatic sample rate/sample width conversions; users shouldn't have to worry about audio formats at all.
• Lots of documentation improvements.

• Work around an obscure standard library issue.
  • Doesn't work on big endian systems - use Python 3.5 to get the proper bugfix for that.
• Handle stereo WAV files correctly.

Changes since 3.1.0:

• Update documentation to account for new releases of Python, PyInstaller, and PyAudio.
  • The new PyAudio version fixes an obscure overflow issue and also makes installation much easier on all platforms.
  • New documentation for the updated PyAudio installation process.
• General documentation improvements.
• Handle errors better and add additional error checks.

Changes since 3.0.0:

• Support for AT&T Speech to Text API.
• Small documentation tweaks.

• MULTIPLE SERVICE SUPPORT! Now you can use Google Speech Recognition, Wit.ai, or IBM Speech to Text to obtain the recognition results.
• Filtering for clicks and pops. This drastically reduces the number of false positives in phrase recognition.
• Better usage examples - ready-to-run and better organized.

The API has also changed somewhat. Here's a quick upgrade guide:

• speech_recognition.Recognizer(language = "en-US", key = "AIzaSyBOti4mM-6x9WDnZIjIeyEU21OpBXqWBgw") changed to speech_recognition.Recognizer().
  • The key and language are now specified in the speech_recognition.recognize_* functions instead.
• For recognizer_instance.listen, speech_recognition.WaitTimeoutError exceptions are thrown rather than OSError exceptions upon timeout.
• The stop function returned by recognizer_instance.listen_in_background now blocks until the background listener actually stops before returning.
• recognizer_instance.recognize(audio_data, show_all = False) has changed to recognizer_instance.recognize_google(audio_data, key = None, language = "en-US", show_all = False).
  • Additionally, when show_all is set, the return value is the raw result from the API call, rather than a list of predictions and their confidences.
  • Note that we specify the key and language here now rather than in the speech_recognition.Recognizer() constructor.
  • speech_recognition.UnknownValueError is now thrown instead of LookupError when speech is unintelligible, and speech_recognition.RequestError is now thrown instead of IndexError or KeyError when recognition fails.
• Added recognizer_instance.recognize_wit and recognizer_instance.recognize_ibm for recognizing with Wit.ai or IBM Speech to Text.

To download, go to the PyPI page!