Metadata-Version: 2.1
Name: google-assistant-library
Version: 1.0.1
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
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 (<2,>=1.4.0)
Requires-Dist: enum34 (<2,>=1.1.6)
Requires-Dist: google-auth (<2,>=1.0.1)
Requires-Dist: requests (<3,>=2.14.2)
Requires-Dist: pathlib2 (<3,>=2.3.0)

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 for devices`_.

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
- Playback of podcasts and news
- Broadcast voice messages

See `Introduction to the Google Assistant Library`_ for a step by step guide on how to get started with the library on Raspberry Pi 3.

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

- Python ``>= 2.7``
- 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 the Actions Console project and the Google account <https://developers.google.com/assistant/sdk/guides/library/python/embed/config-dev-project-and-account>`_.
- Follow the steps to `register a new device model and download the client secrets file <https://developers.google.com/assistant/sdk/guides/library/python/embed/register-device>`_.
- 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 --scope https://www.googleapis.com/auth/gcm --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.

- Register the device and run the demo with device actions::

    google-assistant-demo --project-id PROJECT_ID --device-model-id DEVICE_MODEL

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 for devices: https://developers.google.com/assistant/sdk
.. _Introduction to the Google Assistant Library: https://developers.google.com/assistant/sdk/guides/library/python
.. _pip: https://pip.pypa.io/
.. _GitHub releases page: https://github.com/googlesamples/assistant-sdk-python/releases
.. _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


