Metadata-Version: 2.0
Name: google-assistant-library
Version: 0.1.0
Summary: Google Assistant Library Python wrapper
Home-page: https://developers.google.com/assistant/sdk
Author: Google Assistant SDK Team
Author-email: jordanjtw+assistant-library@google.com
License: Other/Proprietary License
Description-Content-Type: UNKNOWN
Keywords: google assistant library
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.4
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Operating System :: POSIX
Classifier: Topic :: Internet :: WWW/HTTP
Requires-Dist: argparse (==1.4.0)
Requires-Dist: enum34 (==1.1.6)
Requires-Dist: google-auth (==1.0.1)
Requires-Dist: requests (==2.14.2)

Google Assistant Library for Python
===================================

This package contains high level Python_ bindings for the `Google Assistant Library`_.

It is part of the `Google Assistant SDK`_.

It includes the following features:

- "Ok Google" or "Hey Google" hotword detection
- Audio recording
- Assistant response playback
- Timer and alarm features
- Volume ducking and control
- Conversation state management

See `Getting Started with the Raspberry Pi and Python`_ for a step by step guide on how to get started with the library on Raspberry Pi 3.

Supported configuration
-----------------------

- Python ``>= 3.4``
- Architecture: ``linux-arm7l`` and ``linux-x86_64``

Installing
----------

- You can install using pip_.::

    pip install --upgrade google-assistant-library

Authorization
-------------

- `Follow the steps`_ to configure a Google API Console Project and a Google account to use with the Google Assistant SDK.

- Download the ``client_secret_XXXXX.json`` file from the `Google API Console Project credentials section`_ and generate credentials using ``google-oauth-tool``.::

    pip install --upgrade google-auth-oauthlib[tool]
    google-oauthlib-tool --client-secrets path/to/client_secret_XXXXX.json --scope https://www.googleapis.com/auth/assistant-sdk-prototype --save --headless

Usage
-----

- Run the demo::

    google-assistant-demo

- Say "Ok Google" or "Hey Google" followed by a voice query. The demo should
  play back the Assistant's response and log events to the screen.

Reference
---------

- `Reference sample`_ for the Google Assistant Library for Python
- `Google Assistant Library`_ reference

License
-------

See `LICENSE`_ and `LICENSE.third_party`_.

.. _Python: https://www.python.org/
.. _Google Assistant Library: https://developers.google.com/assistant/sdk/reference/library/python
.. _Google Assistant SDK: https://developers.google.com/assistant/sdk
.. _Getting Started with the Raspberry Pi and Python: https://developers.google.com/assistant/sdk/prototype/getting-started-pi-python/
.. _pip: https://pip.pypa.io/
.. _GitHub releases page: https://github.com/googlesamples/assistant-sdk-python/releases
.. _Follow the steps: https://developers.google.com/assistant/sdk/prototype/getting-started-other-platforms/config-dev-project-and-account
.. _Google API Console Project credentials section: https://console.developers.google.com/apis/credentials
.. _LICENSE: https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-library/LICENSE
.. _LICENSE.third_party: https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-library/LICENSE.third_party
.. _google/assistant/library/LICENSE.third_party: https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-library/google/assistant/library/LICENSE.third_party
.. _Reference sample: https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-sdk/googlesamples/assistant/library

