Metadata-Version: 2.0
Name: avs
Version: 0.0.8
Summary: Python implementation of Alexa Voice Service App
Home-page: https://github.com/respeaker/avs
Author: Yihui Xiong
Author-email: yihui.xiong@hotmail.com
License: GNU General Public License v3
Keywords: alexa voice service
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Requires-Dist: click
Requires-Dist: hyper
Requires-Dist: python-dateutil
Requires-Dist: requests
Requires-Dist: tornado

==============================
Python Alexa Voice Service App
==============================

.. image:: https://img.shields.io/pypi/v/avs.svg
        :target: https://pypi.python.org/pypi/avs

.. image:: https://img.shields.io/travis/respeaker/avs.svg
        :target: https://travis-ci.org/respeaker/avs


Features
--------

* Support Alexa Voice Service API v20160207
* `支持DuerOS <https://github.com/respeaker/avs/wiki/%E4%BD%BF%E7%94%A8DuerOS%E7%9A%84AVS%E5%85%BC%E5%AE%B9%E6%9C%8D%E5%8A%A1>`_


To do
-----

* Speaker interface
* Notifications interface

Requirements
-------------

* gstreamer1.0 gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly
* python-gi python-gst gir1.2-gstreamer-1.0
* respeaker python library pocketsphinx (optional, for hands-free keyword spotting)


Get started
------------

1. run ``alexa-auth`` to login Amazon, it will save authorization information to ``~/.avs.json``
2. run ``alexa-tap``, then press Enter to talk with alexa
3. 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. <https://github.com/alexa/alexa-avs-raspberry-pi#61---register-your-product-and-create-a-security-profile>`_

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.

.. _`nicholas-gh/python-alexa-client`: https://github.com/nicholas-gh/python-alexa-client
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage



=======
History
=======

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.


