Hermes Gadget SDK

What Hermes Gadget SDK does

Hermes Gadget turns a small device into a front end for your Hermes Agent: hold a button to talk, release to send, and hear the reply. The screen shows replies, confirmation questions and cards from the agent, and the gadget's LEDs, sensors and other controls can be exposed to Hermes as tools. Hermes does the thinking, so the device uses your agent's own tools, memory and skills.

Supported hardware is ESP32-S3 boards and Raspberry Pi 4 or 5, with a desktop simulator that runs the same device core for trying it without a board. A browser installer flashes boards over USB from Chrome or Edge without a firmware toolchain. The SDK documentation covers adding boards, device actions, sensors and custom faces. Real conversations need Hermes Agent and the Gadget plugin, and voice also needs speech recognition and text-to-speech configured. The README says hardware ports stay experimental until a full physical verification report exists for the exact revision.

Key features

• Push-to-talk voice and text interaction with your Hermes Agent
• ESP32-S3 firmware, Raspberry Pi 4 and 5 Linux client and a desktop simulator
• Browser installer for USB flashing and Wi-Fi pairing
• Device LEDs and sensors exposed as agent tools
• Guides for adding boards, actions, sensors and custom faces

When to use it

• Building a handheld voice gadget for a home Hermes Agent
• Prototyping a device interface in the simulator before buying hardware
• Letting Hermes read a sensor or switch an LED on a Pi

Who it is for: Makers and embedded developers who want a physical front end for their Hermes Agent.

How it fits with Hermes Agent

It is built for Hermes Agent and requires the Hermes Agent plus a Gadget plugin for real conversations.

How to install Hermes Gadget SDK

These commands are copied from the project's README. Check the repository for the latest steps before you run them.

python -m pip install -e ".[dev]"
hermes-gadget build-sim --test
hermes-gadget devserver --pairing
hermes-gadget sim --url ws://127.0.0.1:8765/gadget --board sim-466x466-round

Requirements: For the simulator: Python 3.10+, CMake 3.16+ and a C++17 compiler. For a board: Chrome or Edge, a USB data cable, 2.4 GHz Wi-Fi and Hermes. Voice needs speech recognition and text-to-speech.

Note: Hardware ports remain experimental until a complete physical verification report is recorded for the exact revision.

FAQ