--- title: "Groq" description: "Groq is a Marketplace integration for Home Assistant. It has 116 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026." canonical: "https://vulpo.app/integrations/marketplace/barneyonline-ha-groq" url: "https://vulpo.app/integrations/marketplace/barneyonline-ha-groq.md" last-updated: "2026-10-24" version: "1.4" --- # Groq > Groq is a Marketplace integration for Home Assistant. It has 116 installs sharing analytics, needs the vendor's cloud and was last updated October 25, 2026. Groq is a custom integration that connects a Groq cloud account to Home Assistant for chat, speech and image tasks. It adds Assist conversation agents, AI Task data generation, speech-to-text and text-to-speech entities for voice pipelines. Response actions cover text generation, structured JSON output, image analysis, text extraction from images, audio transcription, translation of speech into English, clearing the response cache and listing models. Optional sensors report usage details such as token counts, response time and cache hit rate. Each Groq service gets its own device, and separate API keys can be used for separate accounts or projects. It needs the Groq cloud and an API key, is set up in the UI, and shows repair notices for problems such as a missing model or missing ffmpeg. Automatic summary of the README and code of barneyonline/ha-groq. Something wrong, or are you the maintainer and want your own text here? [Get in touch](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=barneyonline&repository=ha-groq&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=barneyonline&repository=ha-groq&category=integration) ## Supports - **Uses the vendor's cloud**: Needs an internet connection and an account with the vendor. - **From the Marketplace**: Installed through the Marketplace, formerly HACS. - **Actively maintained**: Its author released or pushed a change in the last six months. ## Setting it up Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services. ### Add Groq - **Name**: A friendly name for this Groq account. Use this to identify the API key or billing project. - **Enter Groq API key**: Groq API key for this account. Add another Groq account if you want to use a different key for a separate set of services. ### Reauthenticate Groq - **Groq API key** ### Reconfigure Groq - **Name**: A friendly name for this Groq account. - **Groq API key**: Optional replacement API key. Leave empty to keep the current API key. ### After setup - **Groq API key**: Optional replacement API key for this Groq account. Texts from the code of [barneyonline/ha-groq](https://github.com/barneyonline/ha-groq). ## Entities - **ai\_task**: Data generation tasks - **conversation**: Assist - **Sensors**: Successful generation requests, Last input tokens, Last output tokens, Last total tokens, Last cached input tokens, Last response time, Last provider cache hit rate - **stt**: Speech-to-Text - **tts**: Text-to-Speech ## Actions - **Generate Text**: Generate a text response with a configured Groq Text Generation service. Fields: Groq Account, Groq Service, Prompt, Model, System Prompt, Temperature, Max Completion Tokens, Top P, Stop Sequences, Seed - **Generate Text Output**: Generate text with a configured Groq Text Generation service. Optionally provide a JSON schema to request structured output from models that support structured outputs. Fields: Groq Account, Groq Service, Prompt, JSON Schema, Schema Name, Strict Schema Mode, Model, System Prompt, Temperature, Max Completion Tokens - **Analyze Image**: Ask a Groq Image Recognition service to describe or answer questions about an image. Fields: Groq Account, Groq Service, Prompt, Camera Entity, Image File, Local Image Path, Image URL, Model - **Extract Text From Image**: Extract visible text from an image with a Groq Image Recognition service. Fields: Groq Account, Groq Service, Camera Entity, Image File, Local Image Path, Image URL, Prompt, Model - **Transcribe Audio**: Transcribe an audio file with a configured Groq Speech-to-Text service. Fields: Groq Account, Groq Service, Audio File, Local Audio Path, Model, Language, Prompt, Response format, Timestamps - **Clear Cache**: Clear cached Groq text generation responses for a Groq account. Fields: Groq Account - **List Models**: List Groq models available to a Groq account. Fields: Groq Account, Refresh From Groq - **Translate Audio**: Translate speech into English using Whisper Large V3. Uses the selected Speech-to-Text service account and rate-limit protection. Fields: Groq Account, Groq Service, Audio File, Local Audio Path, Model, Prompt ## Troubleshooting - **Diagnostics**: Downloads a diagnostics file to attach to a bug report. - **Repair notices**: Notices it can show in Settings, Repairs: ffmpeg is required for Groq audio processing, Groq model is not available, Groq service model configuration is invalid ## From the README > Groq is a cloud API service for fast language, speech, and vision models. This Home Assistant custom integration connects a Groq account to Assist, AI Tasks, speech-to-text, text-to-speech, image analysis, and response actions. > > The Platinum quality-scale label is a repository self-assessment against the current Home Assistant integration quality rules. As a custom integration, ha-groq is not reviewed, security audited, maintained, or supported by the Home Assistant project. The rule-by-rule evidence is tracked in quality\_scale.yaml. From the README of [barneyonline/ha-groq](https://github.com/barneyonline/ha-groq#readme), [GNU GPL v3.0](https://spdx.org/licenses/GPL-3.0.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [AI and voice](https://vulpo.app/integrations/category/ai-and-voice.md), AI models - Number: 116 installs sharing analytics; 2 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: v2.1.0, last updated October 25, 2026 - Domain: `groq` - Source: - Issues: In Vulpo: Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-24. Source: https://vulpo.app/integrations/marketplace/barneyonline-ha-groq --- - HTML version of this page: https://vulpo.app/integrations/marketplace/barneyonline-ha-groq - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml