groqd
A Home Assistant custom integration for Groq Cloud with memory, web search, and link ingestion.
---
## Features
- Multiple instances (different models, personalities, and settings)
- Persistent memory (device/user/global scopes)
- Tool calling via Home Assistant LLM API
- Optional web search via SearxNG
- Auto-fetch and ingest URLs from user messages
- Rich generation controls (temperature, top_p, penalties, max tokens, response format)
## Install (HACS)
1. **Add** this repository to HACS (Integration):
[](https://my.home-assistant.io/redirect/hacs_repository/?owner=sudoxreboot&repository=groqd&category=integration)
Or copy this URL into HACS → Custom repositories:
`https://github.com/sudoxreboot/groqd`
2. Install `groqd` in HACS.
3. Restart Home Assistant.
## Configure
- **Click to add the integration:**
[](https://my.home-assistant.io/redirect/config_flow_start/?domain=groqd)
- Or go to **Settings → Devices & Services → + Add Integration** and search for `groqd`.
## Quick Start
- Create a new groqd entry.
- Set your Groq API key.
- Pick a model (default: `meta-llama/llama-4-maverick-17b-128e-instruct`).
- Set a personality prompt if you want tone/style changes.
## Options
Open **groqd → Options** to configure:
- Memory scope: `device`, `user`, `global`, or `conversation`
- Context window size
- Max tokens, temperature, top_p, penalties
- Response format (`text` / `json_object`)
- SearxNG (enable + URL + language + safe search)
- Auto-fetch URLs in user messages
- Time format (12h / 24h)
## Recommended Prompt Additions
To make tone warmer and lyrical:
"""
Be warm, playful, and a bit lyrical. If the user quotes lyrics, continue one line then respond empathetically.
"""
## Notes
- TTS/STT are handled by Home Assistant and other integrations.
- Web search is optional and only used if enabled.
- Auto-fetch pulls page text and injects it into the prompt for better grounding.
## Support
Open issues or requests at: https://github.com/sudoxreboot/groqd/issues