Adolanium/hermes-gadget-sdk

选用指南

AI 根据 README 整理 · 2026/10/14 13:56:06

使用方式

可通过浏览器安装固件到 ESP32-S3 板，或使用桌面模拟器无需硬件即可体验；也支持在 Linux 上运行。

查看 README 依据

<p align="center"> <img src="docs/images/screen-ready.png" width="226" alt="The round simulator display, ready for a question"> <br>_{The desktop simulator runs the same device core. No board needed to try it.} </p> ## Choose your starting point | I have a board | I want to try it first | I want to build with it | |---|---|---| | [Open the browser installer](https://adolanium.github.io/hermes-gadget-sdk/installer.html) | [Start the desktop simulator](docs/desktop.md) | [Explore the SDK](docs/development.md) |

Hermes Gadget runs on ESP32-S3 boards and Raspberry Pi 4/5, with a desktop simulator for trying it without hardware. See [Supported hardware](docs/supported-hardware.md) 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](docs/hardware-validation.md) before choosing a board. ## Try the demo from a checkout <details> <summary>Already have Python, CMake, and a compiler? Start here.</summary>

部署要求

安装固件需要 Chrome 或 Edge、USB 数据线、2.4 GHz Wi-Fi 和 Hermes；模拟器需要 Python 3.10+、CMake 3.16+ 和 C++17 编译器。

查看 README 依据

| 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.

已知限制

硬件端口在完整物理验证报告记录前仍为实验性；不包含唤醒词激活。

查看 README 依据

Hermes Gadget runs on ESP32-S3 boards and Raspberry Pi 4/5, with a desktop simulator for trying it without hardware. See [Supported hardware](docs/supported-hardware.md) 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](docs/hardware-validation.md) before choosing a board. ## Try the demo from a checkout <details> <summary>Already have Python, CMake, and a compiler? Start here.</summary>

The simulator and firmware share a portable C++17 core. CI tests the core, Python tools, installer, and plugin against a real Hermes gateway, and builds every supported board. The [development guide](docs/development.md) describes the test suites and pinned Hermes version. After installing firmware, you can [configure Wi-Fi from your phone](docs/setup-board.md#set-up-wi-fi-with-your-phone) through the gadget's temporary network. USB setup remains available. Wake-word activation is not included.