numogram: Hermes debugs your ESP32

From its catalog listing

Hermes debugs ESP32 firmware on real hardware. It watches the board's serial port, maps crash addresses to source lines from the ELF, fixes the code, builds with idf.py and flashes with esptool, then reads the log to confirm the fix. A crash wakes the session on its own. Also checks firmware GPIO use against a KiCad netlist (swapped signals, strapping, flash and USB pins) and audits chip security read-only. NUMOGRAM_PORT=virtual runs an emulated ESP32-C3 in Espressif's QEMU, so it works without a board.

Good to know before installing

board_build and board_flash go through Hermes's approval prompt (a pre_tool_call hook, one approval rule per tool) and are blocked when nobody can answer; a build runs ESP-IDF's export.sh, idf.py and the project's own CMake and Python scripts and writes the build directory it is given. Runs esptool, espefuse summary (read-only; the plugin has no eFuse write) and, for the virtual board only, Espressif's qemu-system-riscv32 with networking off, always with fixed argument lists, and each child gets an environment allowlist (PATH, HOME, locale, ESP-IDF variables), never Hermes's keys or tokens. Background: a serial watcher thread while watching is on, and a QEMU process for the virtual board that stops when Hermes exits. Network: none beyond loopback (unauthenticated) to its own macOS USB bridge or virtual board, or the socket:// address set in NUMOGRAM_PORT. Reads the project, build, ELF and netlist paths it is given; writes its own state only under the active Hermes profile's home (get_hermes_home() / numogram). Serial output is passed to the model as untrusted data; wake-up messages are built from fixed text and validated hex. The bridge and virtual board drop eFuse write commands. No credentials, no telemetry.

From its catalog listing.

How to install

  1. Install it. Hermes asks for any API keys it needs, then asks whether to turn it on.
    hermes plugins install numogram
  2. Said no? Turn it on later:
    hermes plugins enable numogram
  3. Restart Hermes so it loads the plugin.

Some plugins also need a sign-in or settings: see Full setup & settings. Memory plugins ask whether to become your memory provider instead. Steps follow the official plugins guide (opens in a new tab).

Category
Everyday life & fun
Maintained by
zblauser (Community)
Needs
No API keys declared
Adds tools
board_build board_pins board_status board_watch board_log board_flash board_crash board_audit board_note
Adds hooks
pre_tool_call pre_llm_call post_llm_call
Works on
linux, macos
Needs Hermes
0.22.7 or newer
Version
0.1.2
In the catalog
2026-11-10

Known issues (from its catalog listing)

  • One board at a time. Building and flashing need an ESP-IDF project; board_build needs ESP-IDF where Hermes runs.
  • Tested end to end on an ESP32-P4 over USB-Serial/JTAG and on the emulated ESP32-C3. Other chips use the same paths but are untested on hardware; crash parsing on Xtensa chips (ESP32, S2, S3) is untested.
  • The macOS bridge supports boards on the chip's own USB-Serial/JTAG port, not boards behind a USB-UART bridge chip.
  • The virtual board needs Espressif's qemu-system-riscv32 (idf_tools.py install qemu-riscv32).
Using the Hermes desktop app? See where plugins live
Hermes desktop Capabilities page, Plugins tab filtered to Official plugins built by Nous Research, each with an add button.
The official plugin catalog built into the app.Hermes desktop v0.22.5 · Capabilities > Plugins · Windows · captured Nov 1, 2026

Full setup & settings ↗Source code ↗

More in everyday life & fun

All everyday life & fun plugins

New Hermes Agent updates every day on X. Follow @HermesWatcher

← All plugins