gadget.yaml 3.2 KB

123456789101112131415161718192021222324252627282930313233
  1. name: gadget
  2. repo: https://github.com/Adolanium/hermes-gadget-sdk
  3. sha: 0b957aae2f7f11904a9daab031f1378a45de21dc
  4. subdir: plugin
  5. title: Hermes Gadget
  6. description: "Talk to your Hermes from small ESP32 devices with a screen, microphone and speaker: hold a button, ask, and hear the answer. Adds a gateway platform where each device is a chat, plus tools to list devices, show a card on a screen and run device actions (LEDs, relays). Disclosure — the gateway listens for devices on a WebSocket port (8765, all interfaces by default; plain ws:// unless tls_cert/tls_key are set). New devices need a Hermes pairing code unless listed in GADGET_ALLOWED_USERS; GADGET_ALLOW_ALL_USERS skips pairing (development only). A paired device answers the agent's command approvals for its own chat (allow once or deny), within Hermes's approval timeout. The first approved device becomes the platform's home channel by default. Session hooks feed a dashboard on paired devices with each agent session's platform, a short id and its state (idle, busy, waiting for approval); a device that can switch profiles also sees the offered profiles' sessions. Optional profile switching (off unless `profiles` is set in the default profile's gadget config) lets a device paired on the default profile talk to the listed profiles; each profile approves the device through its own pairing flow (the device shows the `hermes -p <profile> pairing approve` command), the plugin writes nothing into other profiles, and revoking the device in the default profile sends it back there. Spoken replies that are not WAV are converted with the local ffmpeg; Opus reply audio uses the host's libopus when installed (loaded with ctypes, not bundled). `hermes gadget update --latest` downloads firmware from this repository's GitHub releases, checks size and SHA-256 against the release manifest (files carry build provenance attestations) and sends it to the device. Writes only under plugin-data/gadget/. Uses Hermes's own STT, TTS and image cache; no telemetry. Independent community project, not affiliated with Nous Research."
  7. maintainer: Adolanium
  8. tier: community
  9. category: platform
  10. requires_hermes: ">=0.21.6"
  11. docs_url: https://adolanium.github.io/hermes-gadget-sdk/docs/connect-hermes.html
  12. version: "0.3.0"
  13. image: https://raw.githubusercontent.com/Adolanium/hermes-gadget-sdk/0b957aae2f7f11904a9daab031f1378a45de21dc/docs/images/banner.webp
  14. screenshots:
  15. - https://raw.githubusercontent.com/Adolanium/hermes-gadget-sdk/0b957aae2f7f11904a9daab031f1378a45de21dc/docs/images/sim-window.png
  16. - https://raw.githubusercontent.com/Adolanium/hermes-gadget-sdk/0b957aae2f7f11904a9daab031f1378a45de21dc/docs/images/screen-listening.png
  17. - https://raw.githubusercontent.com/Adolanium/hermes-gadget-sdk/0b957aae2f7f11904a9daab031f1378a45de21dc/docs/images/screen-reply.png
  18. - https://raw.githubusercontent.com/Adolanium/hermes-gadget-sdk/0b957aae2f7f11904a9daab031f1378a45de21dc/docs/images/screen-prompt.png
  19. capabilities:
  20. provides_tools:
  21. - gadget_devices
  22. - gadget_display
  23. - gadget_action
  24. provides_hooks:
  25. - on_session_start
  26. - pre_llm_call
  27. - on_session_end
  28. - pre_approval_request
  29. - post_approval_response
  30. - on_session_finalize
  31. - on_session_reset
  32. provides_middleware: []
  33. requires_env: []