avs 0.1.1

Python implementation of Alexa Voice Service App

Python Alexa Voice Service App

Features

• Support Alexa Voice Service API v20160207

• 支持DuerOS

To do

• Speaker interface

• Notifications interface

Requirements

• gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gir1.2-gstreamer-1.0

• python-gi python-gst-1.0 python-pyaudio

• respeaker python library and pocketsphinx (optional, for hands-free keyword spotting)

Installation

• For ReSpeaker Core (MT7688), gstreamer, pyaudio and pocketsphinx and respeaker python library are installed by default, just run pip install avs

• For Ubuntu/Debian:

  sudo apt-get install gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly \
  gir1.2-gstreamer-1.0 python-gi python-gst-1.0 python-pyaudio
  sudo pip install avs respeaker pocketsphinx

Get started

1. run alexa-audio-check to check if recording & playing is OK. If RMS is not zero, recording is OK, if you can hear alarm, playing is OK:

   $alexa-audio-check RMS: 41 RMS: 43

2. run alexa-auth to login Amazon, it will save authorization information to ~/.avs.json

3. run alexa-tap, then press Enter to talk with alexa

4. run alexa, then use “alexa” to start with conversation with alexa, for example, “alexa, what time is it”

Change Alexa Voice Service client id and product id

If you want to use your own client id and product id, try:

1. register for an Amazon Developer Account.

2. create a file named config.json with your product_id, client_id and client_secret:

   {
       "product_id": "x",
       "client_id": "y",
       "client_secret": "z"
   }

3. run alexa-auth -c config.json

4. run alexa-tap or alexa

License

• Free software: GNU General Public License v3

Credits

This project is based on nicholas-gh/python-alexa-client.

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.1 (2017-12-29)

• bugfix

0.1.0 (2017-12-27)

• support TuneIn audio stream

• add alexa-audio-check util

0.0.9 (2017-09-29)

• add LED light for respeaker core and respeaker usb mic array

• add inactive time report event

0.0.8 (2017-09-25)

• limit audio queue length, fix string to invalid filename

0.0.7 (2017-08-31)

• able to handle a few kind of connection failures and do reconnection

0.0.6 (2017-08-30)

• fix dueros oauth invalid access token issue

• fix dueros-auth

0.0.5 (2017-08-24)

• support alerts interface

0.0.4 (2017-07-13)

• add hands free alexa util using respeaker python library

0.0.3 (2017-07-11)

• use gstreamer to play audio stream

• support dueros avs compatible service

• many improments

0.0.2 (2017-07-05)

• rename alexa util to alexa-tap

• add oauth util alexa-auth

0.0.1 (2017-07-04)

• First release on PyPI.