Raspberry-Pi Instructions:
Raspbian preparation
- download raspbian jessie lite (no xserver, only headless)
- put on sd card
- enable SSH by putting a file named 'ssh' in the boot partition (https://www.raspberrypi.org/documentation/remote-access/ssh/ see enable ssh)
Alexa steps
- connect to raspi with ssh client (putty on windows or ssh on linux) username pi, password raspberry
- install git:
sudo apt-get install git
- clone repository:
git clone https://github.com/SamuelBrucksch/alexa-avs-sample-app/
cd alexa-avs-sample-app
- enter Device ID, and the other 2 Strings like in the original instructions
. automated_install.sh
- if you want to make use of the additional features added here you need to select auto start and enter working credentials
- At the end of the automated install it prints out commands to start AWS however on reboot it should start automatically so those steps are not required.
- (optional) configure alsa based on your config. you can test with aplay test.wav and arecord -d 10 test.wav, both should work without any additional parameters. If both commands work then alexa will work as well (at least audio wise).
- (optional) increase speaker volume as default is quite low, open
alsamixer
to increase volume and save withsudo alsactl store
- reboot
About the project
This project provides a step-by-step walkthrough to help you build a hands-free Alexa Voice Service (AVS) prototype in 60 minutes, using wake word engines from Sensory or KITT.AI. Now, in addition to pushing a button to "start listening", you can now also just say the wake word "Alexa", much like the Amazon Echo. You can find step-by-step instructions to set up the hands-free prototype on Raspberry Pi, or follow the instructions to set up the push-to-talk only prototype on Linux, Mac, or Windows.
NEW! - Click here for instructions to build the AVS Prototype using a Raspberry Pi and the Conexant 2-Mic Development Kit for Amazon AVS
What is AVS?
Alexa Voice Service (AVS) is Amazon’s intelligent voice recognition and natural language understanding service that allows you as a developer to voice-enable any connected device that has a microphone and speaker.
What's new?
January 30, 2017:
The AVS java sample app has been updated with the following changes:
- Added support for the SetEndpoint directive.
See sample code »
Read the docs » - Added support for the Settings Interface.
See the code »
Read the docs » - Added locale switcher (en-US, en-GB, de-DE) to sample app user interface.
For information on how to update your client code, see Preparing for Internationalization on the Amazon Developer Portal.
December 8, 2016:
The AVS java sample app for Raspberry Pi has been updated for two changes:
- The sample app now supports GPIO triggers for use with the Conexant 2-Mic Development Kit for Amazon AVS. Click here for step-by-step instructions.
- The sample app is now officially certified for media and music services.
October 6, 2016:
How is this different from the last Amazon Alexa Pi project? That's easy, two wake word engines are included with this project - TrulyHandsFree from Sensory and Snowboy from KITT.AI. When you're finished, you'll have a working voice-enabled AVS prototype.
Important considerations
-
The earcons associated with the sample project are for prototyping purposes only. For implementation and design guidance for commercial products, please see Designing for AVS and AVS UX Guidelines.
-
Alexa Voice Service Terms & Agreements
-
Usage of Sensory & KITT.AI wake word engines: The wake word engines included with this project (Sensory and KITT.AI) are intended to be used for prototyping purposes only. If you are building a commercial product with either solution, please use the contact information below to enquire about commercial licensing -
- Contact Sensory for information on TrulyHandsFree licensing.
- Contact KITT.AI for information on SnowBoy licensing.
-
IMPORTANT: The Sensory wake word engine included with this project is time-limited: code linked against it will stop working when the library expires. The library included in this repository will, at all times, have an expiration date that is at least 120 days in the future. See Sensory's GitHub page for more information on how to renew the license for non-commercial use.
Get Started
You can set up this project on the following platforms. Please choose the platform you'd like to set this up on -
- Raspberry Pi, or
- Linux, or
- Mac, or
- Windows
- New! Raspberry Pi + Conexant 2-Mic Development Kit for Amazon AVS