Groq Cloud API integration for Home Assistant 🏠

This is a custom integration for using Groq Cloud API in the Assist pipeline, reducing the workload on the Home Assistant server.

Groq Cloud provides multiple models like Llama 3.1, Gemma2, Groq for free! And no card required! (For now...)

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. Add ➕ this repository to your HACS repositories:

   • Click on this link ⤵️

     

   • Or copy this url ⤵️ and paste into your HACS custom repostories

     https://github.com/HunorLaczko/ha-groq-cloud-api

2. Install 💻 the Groq Cloud API 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 🔧

For the options check out the OpenAI Conversation integration here.

For the available models check out Groq Cloud.

Reasoning Effort 🧠

Some models support a "reasoning effort" parameter that controls how much computation the model uses for reasoning tasks. To enable this:

1. Check the "Model supports reasoning effort" toggle in the integration options. (Make sure you only turn it on for models that support it, otherwise the API will return an error)
2. Submit, then open the configuration again. A reasoning effort field will appear:
   • For Qwen models (e.g., qwen/qwen3-32b): A dropdown with options default or none
   • For GPT-OSS models (e.g., openai/gpt-oss-20b, openai/gpt-oss-120b): A dropdown with options low, medium, or high
   • For other models: A text field where you can enter a custom value

If the toggle is not enabled, no reasoning effort parameter will be sent to the API.

Home Assistant Dashboard 💻

• Configure the integration by clicking here ⤵️

  

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

Acknowledgements

The code base is mostly identical OpenAI Conversation integration, just using the official Groq library instead of OpenAI.

The Readme and HACS setup is based on Fabio's excellent work with the Groq Whisper integration. Check out his other works as well!