Home

Groq Home Assistant Integration

Groq is an unofficial Home Assistant custom integration for Groq cloud AI services.

It can add Home Assistant services and entities for:

• Text Generation for Assist, AI Tasks, automations, structured outputs, reasoning-capable models, prompt caching, and Groq Compound models
• Speech-to-Text for Home Assistant voice pipelines
• Text-to-Speech using Groq Orpheus models
• Image Recognition for camera snapshots and image URLs

Important

This is an unofficial community project. It is not affiliated with, endorsed by, or supported by Groq.

Groq model availability, account limits, rate limits, and feature support can vary by Groq account, project, and model.

Quick Links

• Installation
• Account and Service Setup
• Text Generation
• Speech-to-Text
• Text-to-Speech
• Image Recognition
• Troubleshooting
• Development

Requirements

• A recent Home Assistant version with config subentry support
• A Groq API key from the Groq Console
• Network access from Home Assistant to Groq APIs
• ffmpeg on the Home Assistant host if you enable Text-to-Speech audio normalization

How The Integration Is Organized

The first Groq setup flow creates a Groq account entry. That entry stores the friendly account name and API key.

After adding the account, open the Groq integration page and add one or more named service entries:

• Add Text Generation
• Add Speech-to-Text
• Add Text-to-Speech
• Add Image Recognition

Each service has its own name, model, and service-specific options. Add multiple services when you want separate defaults, such as one Text Generation service for Assist and another for structured automation output.

Repository Links

• Repository
• Issues
• Groq Console
• Groq status