Install
hermes plugins install webdevtodayjason/hermes/plugin --enable ~/.hermes/hermes-agent/venv/bin/pip install pyserial hermes gateway restart
Plug the familiar into any USB port — she's found automatically and survives
unplug/replug. /familiar in any Hermes chat shows link status;
/familiar say hello is the ten-second voice test.
note The repo goes public with the first release — until then this command works for collaborators only.
What it wires up
| Gateway event | On the device |
|---|---|
| agent thinking / using tools | portrait animates, activity label ("searching the web…") |
| reply sent (any platform) | message ticker + banner toast on any tab |
| dangerous-command approval pending | ALLOW / DENY takeover, pulse + chirp until answered — your tap resolves the real approval |
agent calls familiar_notify | banner + chirp, optionally spoken aloud |
| kanban task claimed / done / blocked | ticker; blocked tasks alert the desk |
| daily at 18:30 (configurable) | the evening ritual: a spoken digest of the day, composed by your own model |
Voice uses your gateway's own TTS config (ElevenLabs, OpenAI, Edge — whatever you run);
audio streams over your LAN to her speaker. Configuration lives in
~/.hermes/familiar_actions.json — action buttons, voice, quiet options,
all documented in the repo.