Skip to content
This repository has been archived by the owner on Aug 30, 2024. It is now read-only.

HACS custom integration for using GroqCloud speech-to-text (Whisper) API in the Assist pipeline, reducing the workload on the Home Assistant server.

License

Notifications You must be signed in to change notification settings

fabio-garavini/ha-groq-whisper-stt-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 

Repository files navigation

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. Addthis repository to your HACS repositories:

    • Click on this link ⤵️

      Add Repository to HACS

    • 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 ⤵️

    Add Repository to HACS

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

About

HACS custom integration for using GroqCloud speech-to-text (Whisper) API in the Assist pipeline, reducing the workload on the Home Assistant server.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages