python-alexa-voice-service

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #claude-code #codex #cli #developer-tools #react #windows

python-alexa-voice-service

★ 45 Open GitHub ↗

A Python implementation of Amazon's Alexa Voice Service.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Python Alexa Voice Service

This project is a Python implementation of Amazon's Alexa Voice Service (AVS). The goal of this project is to create cross-platform example Alexa device that is completely compatible with the current AVS API (v20160207). This is a work in progress.

## Requirements
- [Python 3.5+](https://www.python.org/)
	- [cherrypy](http://www.cherrypy.org/)
    - [requests](http://docs.python-requests.org/en/master/)
    - [hyper](https://hyper.readthedocs.org/en/latest/) (developer branch)
	- [pyaudio](https://people.csail.mit.edu/hubert/pyaudio/)
	- [speech_recognition](https://github.com/Uberi/speech_recognition#readme)
- [ffmpeg](https://ffmpeg.org/)
- [Microphone](http://amzn.to/1rvSxuS) and speaker

## Getting Started

Install the necessary requirements and clone the repository.

``
git clone https://github.com/nicholasjconn/python-alexa-voice-service
``

``
cd python-alexa-voice-service
``

Extract and copy the ffmpeg folder to the project's folder. Rename to ffmpeg, so that the ffmpeg command is located in python-alexa-voice-service/ffmpeg/bin/ffmpeg.

Follow the directions from Amazon on how to get your Client ID, Client Secret, and ProductID (parts of Chapter 3 and Chapter 6).

[https://github.com/amzn/alexa-avs-raspberry-pi](https://github.com/amzn/alexa-avs-raspberry-pi)

Rename config_example.dict to config.dict. Then open the file and update the Client ID, Client Secret, and ProductID values to your own values

Run the main.py script. If you run into any errors, chances are that you have missed one of the requirements.

``
python3 main.py
``

## Using the Code

This is a command line based program. You will be receive notices and prompts via the command line. Start a voice command by pressing enter. The software is not always listening (I am waiting on a response from Amazon before enabling this), so a button press is required to active the microphone.

When you would like to close the program, press 'q' and then enter.

Errors and other text may be printed out if anything goes wrong. This is a work in progress.

#### Example Alexa Commands
* "What time is it?"
* "Set an alarm."
* "Where am I?"
* "What is the weather tomorrow?"
* "Are you a robot?"

If you have the Wink hub or any other supported home automation devices, you can connect them via the [Android Alexa App](https://play.google.com/store/apps/details?id=com.amazon.dee.app&hl=en). Once connected, you can say things like "turn on bedroom lights" or "set bedroom lights to 50%".

Have fun!

## Cross-Platform

This code has only been tested on Windows. This project will eventually support Linux and hopefully OS X. The final goal is for this project to work out of the box on a Raspberry Pi.

## Alexa Voice Service

The following link has all of the information needed to understand the Alexa Voice Service API:

[https://developer.amazon.com/public/solutions/alexa/alexa-voice-service/content/avs-api-overview](https://developer.amazon.com/public/solutions/alexa/alexa-voice-service/content/avs-api-overview)

## Bugs

If you run into any bugs, please create an issue on GitHub. Don't hesitate to submit bugs for the README.md as well! I can't promise that I will get to it quickly, but I will do my best to keep this project as bug free as possible (given the time I have to work on it).

## Contributing

Feel free contribute to the code! I will be actively adding new feature until it is full-featured. If you get 
to a feature before me, I may be able to use your code!

## License
MIT - [See LICENSE](./license.txt)

## Future Work
Please feel free to add functionality or fix any bugs that you find. I will be working on this project whenever I have time, so stay tuned for updates.

Currently, only the SpeechRecognizer and SpeechSynthesizer interfaces are supported. More will be added in the near future.

## Change Log
* Version 0.2 - Added Alert (alarm and timer) functionality, and updated README.md

python-alexa-voice-service

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README