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
24 commits 1 branch 3 tags 78 KiB
Python 100%
Find a file
Your Name 0760f8ca67 fix time pronunciation in spoken responses 
changed prompt instruction to use natural spoken format for times instead of numeric format, preventing LLM from saying "three thousand thirty-four" instead of "three thirty-four"
2025-12-20 17:45:08 -06:00
assets Add icon and expand README 2025-12-20 15:41:03 -06:00
custom_components/groqd fix time pronunciation in spoken responses 2025-12-20 17:45:08 -06:00
hacs.json Initial groqd integration 2025-12-20 10:53:01 -06:00
README.md Add HACS badges and install instructions 2025-12-20 15:45:25 -06:00

README.md

groqd

groqd

A Home Assistant custom integration for Groq Cloud with memory, web search, and link ingestion.

Add Repository to HACS Configure integration

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):

    Add Repository to HACS

    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:

    Configure integration

  • 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