Skip to content

Latest commit

 

History

History
95 lines (63 loc) · 4.34 KB

README.md

File metadata and controls

95 lines (63 loc) · 4.34 KB
Raw

Hass.io Core Add-on: Google Assistant SDK

Load and update configuration files for Home Assistant from a Git repository.

Supports aarch64 Architecture Supports amd64 Architecture Supports armhf Architecture Supports armv7 Architecture Supports i386 Architecture

About

Google Assistant is an AI-powered voice assistant that runs on the Raspberry Pi and x86 platforms and interact via the DialogFlow integration with Home-Assistant. You can also use Google Actions to extend its functionality.

⚠️ These instructions are outdated

These instructions are outdated - the add-on has been updated and these are no longer accurate or complete. Any help in improving the add-on or this document is highly appreciated.

ℹ️ Integration your mobile or Google/Nest Home with Home Assistant

If you want to integrate your Google Home or mobile phone running Google Assistant, with Home Assistant, then you want the Google Assistant integration.

Installation

Follow these steps to get the add-on installed on your system:

  1. Navigate in your Home Assistant frontend to Hass.io -> Add-on Store.
  2. Find the "Google Assistant SDK" add-on and click it.
  3. Click on the "INSTALL" button.

How to use

Fist, select the input and output audio devices to use for the Assistant in the "Audio" section of the add-on configuration.

To enable access to the Google Assistant API, do the following:

  1. In the Cloud Platform Console, go to the Projects page. Select an existing project or create a new project
  2. Open the project. In the top of the page search for Google Assistant API or use this link and enable it.
  3. Create an OAuth Client ID, pick type "Other", click "Create" and download the JSON file by clicking the Download JSON button on the right side.

Now install and activate the Samba add-on so you can upload your credential file. Connect to the "share" Samba share and copy your credentials over. Name the file google_assistant.json.

The next step is to authenticate your Google account with Google Assistant. Start the add-on and click on the "OPEN WEB UI" button to start authentication.

Configuration

Add-on configuration:

{
  "client_secrets": "google_assistant.json",
  "project_id": "project_id_from_google",
  "model_id": "model_id_from_google"
}

Option: clients_secrets (required)

The name of the client secrets file to you've downloaded from Google and placed in your /share folder.

Option: project_id (required)

Project ID of the project you've created at Google for this add-on.

Option: model_id (required)

The ID of the model you've registered at Google for this add-on.

Support

Got questions?

You have several options to get them answered:

In case you've found a bug, please open an issue on our GitHub.