Installation

Installation

HACS

1. Open Home Assistant.
2. Go to HACS.
3. Open Integrations.
4. Open Custom repositories.
5. Add https://github.com/barneyonline/ha-groq as an Integration repository.
6. Install Groq.
7. Restart Home Assistant.
8. Go to Settings -> Devices & services -> Add integration -> Groq.
9. Enter a friendly account name and your Groq API key.
10. Open the Groq integration page and add the service type you want to use.

Manual Install

1. Download or clone the repository.
2. Copy custom_components/groq into your Home Assistant custom_components directory.

<homeassistant_config_dir>/
  custom_components/
    groq/
      __init__.py
      manifest.json
      ...

3. Restart Home Assistant.
4. Go to Settings -> Devices & services -> Add integration -> Groq.
5. Enter a friendly account name and your Groq API key.
6. Open the Groq integration page and add the service type you want to use.

After Installation

The initial setup only creates the Groq account entry. Service-specific behavior is added separately from the integration page:

• Add Text Generation for Assist, AI Tasks, and groq.generate_text
• Add Speech-to-Text for voice pipeline transcription
• Add Text-to-Speech for tts.speak
• Add Image Recognition for groq.analyze_image

Updating

When installed through HACS, update the integration from HACS and restart Home Assistant.

For manual installs, replace the custom_components/groq directory with the updated version and restart Home Assistant.