search

chatziko / ha-google-cloud-stt

Use Google Cloud Speech-to-Text in Home Assistant.
53 stars 13 forks source link

readme

Google Cloud Speech-To-Text for Home Assistant

hacs_badge

This integration allows to use Google Cloud Speech-to-Text in Home Assistant.

Install

You can install this integration via HACS. Go to HACS / Integrations / Three-dots menu / Custom repositories and add:

Then install the "Google Cloud Speech-To-Text" integration.

Configure

To use it you need to configure a Google Cloud project, following the same instructions as the Google Cloud Text-to-Speach integration. Then place the JSON file with the API key you downloaded in the config folder, and add the following to your configuration.yaml:

stt:
  - platform: google_cloud_stt
    key_file: googlecloud.json
    model: command_and_search

After enabling the integration, you can configure a Voice Assistant to use it by selecting google_cloud_stt in the "Speech-to-text" option.

The supported languages are listed here. Note that V1 of Google Cloud Speech-to-Text is used (it is available in more languages and has a free tier). The list of available models is avaiable here. The default model is command_and_search, since it is available in most languages and should perform well in home automation tasks.

FAQ

I get the following error in the Home Assistant system log

  The stt integration does not support any configuration parameters, got [{'platform': 'google_cloud_stt', 'key_file': 'google-cloud-service-googlecloud.json', 'model': 'command_and_search'}]. Please remove the configuration parameters from your configuration.

This is a known issue due to a bug in Home Assistant >= 2023.7. However, the reported message does not affect the functionality of this integration, it should still work as expected (if properly configured).

How much does it cost to use Google Cloud Speech-To-Text?

At the time of writing the pricing of Google Cloud Speech-to-Text V1 is:

Check Google's pricing table for up-to-date information.