google-assistant-library

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.