connectd/groqd
1
0
Fork 0
mirror of https://github.com/sudoxreboot/groqd synced 2026-04-14 03:26:35 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
22 commits 1 branch 3 tags 78 KiB
Python 100%
Find a file
Your Name c5b6f1d172 Add icon and expand README
2025-12-20 15:41:03 -06:00
assets Add icon and expand README 2025-12-20 15:41:03 -06:00
custom_components/groqd Add time format option and enforce numeric time 2025-12-20 15:38:24 -06:00
hacs.json Initial groqd integration 2025-12-20 10:53:01 -06:00
README.md Add icon and expand README 2025-12-20 15:41:03 -06:00

README.md

groqd

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 repo as a Custom Repository in HACS (type: Integration): https://github.com/sudoxreboot/groqd
  2. Install groqd.
  3. Restart Home Assistant.
  4. Add the integration from Settings → Devices & Services.

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