Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fabio-garavini/ha-openai-whisper-stt-api
HACS custom integration for using Whisper speech-to-text (OpenAI or GroqCloud) API in the Assist pipeline, reducing the workload on the Home Assistant server.
https://github.com/fabio-garavini/ha-openai-whisper-stt-api
groq home-assistant openai stt whisper
Last synced: 18 days ago
JSON representation
HACS custom integration for using Whisper speech-to-text (OpenAI or GroqCloud) API in the Assist pipeline, reducing the workload on the Home Assistant server.
- Host: GitHub
- URL: https://github.com/fabio-garavini/ha-openai-whisper-stt-api
- Owner: fabio-garavini
- License: agpl-3.0
- Created: 2024-03-06T11:11:59.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2024-12-26T12:43:11.000Z (26 days ago)
- Last Synced: 2024-12-26T13:33:23.509Z (26 days ago)
- Topics: groq, home-assistant, openai, stt, whisper
- Language: Python
- Homepage:
- Size: 59.6 KB
- Stars: 21
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Whisper STT Cloud API integration for Home Assistant 🏠🎙️
This HA custom integration lets you use any compatible OpenAI API (OpenAI, GroqCloud, others coming ...) for computing speech-to-text in cloud, reducing workload on Home Assistant server.
## Sources
- *OpenAI*
- *GroqCloud*
- others coming ...
## OpenAI
### Requirements 📖
- An OpenAI account 👤 --> You can create one [here](https://platform.openai.com/signup)
- An `API Key` 🔑 --> You can generate one [here](https://platform.openai.com/api-keys)
### Models
- `whisper-1` - At the moment is the only model available, despite the name this is the *whisper-large-v2* model
## GroqCloud
### Requirements 📖
- An GroqCloud account 👤 --> You can create one [here](https://console.groq.com/login)
- An `API Key` 🔑 --> You can generate one [here](https://console.groq.com/keys)
### Models
Currently all GroqCloud Whisper models are free up to 28800 audio seconds per day!
- `whisper-large-v3`
- `distil-whisper-large-v3-en` - optimzed version of *whisper-large-v3* **only for english** language
## 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](https://my.home-assistant.io/redirect/hacs_repository/?owner=fabio-garavini&repository=ha-openai-whisper-stt-api&category=integration) to your HACS repositories:
- **Click** on this link ⤵️
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=fabio-garavini&repository=ha-openai-whisper-stt-api&category=integration)
- Or **copy** this url ⤵️ and paste into your HACS custom repostories
```url
https://github.com/fabio-garavini/ha-openai-whisper-stt-api
```
2. **Install** 💻 the `OpenAI Whisper Cloud` 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) api key
- `model`: (Required) Check your source API
- `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** ⤵️
[](https://my.home-assistant.io/redirect/config_flow_start/?domain=openai_whisper_cloud)
- Or navigate to your `Devices & services` page and click `+ Add Integration`