README.md

Hass.io Core Add-on: Snips.AI

Support for Snips.ai voice assistant.

About

Snips.ai is an AI-powered voice assistant that runs on the Raspberry Pi 3 and x86 platforms. In contrast to Google Assistant or Amazon Alexa, it runs on-device and is private by design.

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 "Snips.AI" add-on and click it.
3. Click on the "INSTALL" button.

How to use

Home Assistant comes with certain Intents builtin to handle common tasks. A complete list of Intents can be found in this wiki Hass Snips Bundle.

The Snips add-on by default comes with an assistant that allows you to turn on lights or switches, open covers, or add and list items to a Shopping List if that integration is enabled.

If using a USB microphone and speakers plugged into the Raspberry Pi output, Snips will work without any change to the configuration. Trying saying things like:

Turn on kitchen light
Open garage door
What is on my shopping list

To get started creating your own configuration, follow their tutorial to create an assistant and download the training data. You can also add the Home Assistant Skill to your assistant to enable the built-in intents, and add or create your own intents to do more complex tasks.

Now install and activate the Samba add-on so you can upload your training data. Connect to the "share" Samba share and copy your assistant over. Name the file assistant.zip or whatever you have configured in the configuration options.

Now it's time to start Snips for the first time. You can configure the microphone and sound card using the Add-on interface. Now start the add-on.

Configuration

Add-on configuration:

{
  "assistant": "assistant.zip",
  "language": "en",
  "custom_tts": {
      "active": false,
      "platform": "amazon_polly"
  }
}

Option: assistant

The name of your custom assistant in /share. If no assistant is found, then a default assistant will be used.

Option: language

This is used to select the default custom assistant. Currently, en, de and fr are supported.

Option group custom_tts

Specifies whether a custom tts should be used. And if so, which custom tts.

Option custom_tts.active

Indicates whether a custom tts is used or not.

Option: custom_tts.platform

Specifies which TTS platform to use.

Support

Got questions?

You have several options to get them answered:

• The Home Assistant Discord Chat Server.
• The Home Assistant Community Forum.
• Join the Reddit subreddit in /r/homeassistant

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