Adolanium / hermes-gadget-sdk

Hermes Gadget 
 Hold a button. Ask Hermes. Hear the answer. 
 A small device for your own Hermes Agent , with its tools, memory, and skills.
 Set up a board ·
 Try the simulator ·
 Read the docs 
 The desktop simulator runs the same device core. No board needed to try it. 
## Choose your starting point
| I have a board | I want to try it first | I want to build with it |
|---|---|---|
| Open the browser installer | Start the desktop simulator | Explore the SDK |
| Install over USB, connect Wi-Fi, and pair with your Hermes. | Try a scripted demo, then connect your own Hermes. | Add a board, device actions, sensors, or your own face. |
| Chrome or Edge, a USB data cable, 2.4 GHz Wi-Fi, and Hermes. No firmware toolchain. | Python 3.10+, CMake 3.16+, and a C++17 compiler. | Start with the development guide and tests. |
## What you can do
- **Talk and listen.** Hold TALK to speak, release to send, and hear your Hermes reply.
- **See what is happening.** Read replies, answer confirmation questions, and receive cards from your agent.
- **Let Hermes act.** Expose the gadget's LEDs, sensors, and other controls as agent tools.
Your Hermes does the thinking. Real conversations need Hermes Agent and the Gadget plugin. Voice also needs speech recognition and text-to-speech configured. The demo server gives scripted replies. Follow Connect Hermes when you are ready.
## Supported hardware
Hermes Gadget runs on ESP32-S3 boards and Raspberry Pi 4/5, with a desktop simulator for trying it without hardware. See Supported hardware to compare boards, controls, audio, and setup options.
Hardware ports remain experimental until a complete physical verification report is recorded for the exact revision. Check the verification table before choosing a board.
## Try the demo from a checkout
 Already have Python, CMake, and a compiler? Start here. 
In your activated environment at the repository root:
 [code] 
In a second terminal with the same environment activated:
 [code] 
Type `approve ` in the first terminal, using the code on the device. Type a message in the simulator to receive a streamed echo. The desktop guide covers platform-specific prerequisites and live audio.
## On the screen
| Ready | Listening | Thinking | Speaking |
|:---:|:---:|:---:|:---:|
| | | | |
These images show the simulator's device display. The simulator guide covers its desktop controls, board profiles, and scripted runs.
## Find the right guide
| Use a gadget | Build with the SDK |
|---|---|
| Choose a starting point | Development and tests |
| Set up a board | Add a board, actions, or sensors |
| Try the simulator | Customize the face |
| Run a Linux gadget | Hardware verification |
| Connect Hermes | Architecture |
| What the plugin does on your machine | |
| Talk, type, and interrupt | Protocol |
| Change Wi-Fi or update firmware | Hermes integration reference |
| Remote access with Tailscale Funnel | |
| Troubleshooting | Hardware and wiring |
## Project status
See the changelog for release