README.md

GroqCloud Whisper STT API integration for Home Assistant 🏠🎙️

This is a custom integration for using GroqCloud speech-to-text API in the Assist pipeline, reducing the workload on the Home Assistant server.

Whisper (whisper-large-v3) usage is free up to 28800 audio seconds per day! And no card required!

Requirements 📖

• An GroqCloud account 👤 --> You can create one here
• An API Key 🔑 --> You can generate one here

How to install ⚙️

Before configuring the integration you must first install the custom_integration. You can do it through HACS or manually

HACS ✨

1. Add ➕ this repository to your HACS repositories:

   • Click on this link ⤵️

     

   • Or copy this url ⤵️ and paste into your HACS custom repostories

     https://github.com/fabio-garavini/ha-groq-whisper-stt-api

2. Install 💻 the GroqCloud Whisper integration

3. Restart 🔁 Home Assistant

Manual Install ⌨️

1. Download this repository
2. Copy everything inside the custom_components folder into your Home Assistant's custom_components folder.
3. Restart Home Assistant

Configuration 🔧

These are the parameters that you can configure:

• api_key: (Required) GroqCloud api key
• model: (Required) At the moment the only model available is whisper-large-v3
• temperature: (Optional) Sampling temperature between 0 and 1. Default 0
• prompt: (Optional) Can be used to improve speech recognition of words or even names. Default ""
  You have to provide a list of words or names separated by a comma ,
  Example: "open, close, Chat GPT-3, DALL·E".

Now you can set it up through your Home Assistant Dashboard (YAML configuration not supported).

Home Assistant Dashboard 💻

• Configure the integration by clicking here ⤵️

  

• Or navigate to your Devices & services page and click + Add Integration