Files
meshtastic/plugin
eric ba31d79368 fix(e2e): headless TkAgg crash + readiness false-positive on forwards
Run 10536 reached pytest but every connect was reset: the simulator died at
import with 'Tkinter is needed' — lib/gui.py calls matplotlib.use("TkAgg")
unconditionally (an explicit use() overrides MPLBACKEND=Agg), and the port
probe passed instantly because it was accepting the localhost forwarders, not
the nodes.

- run_e2e.sh: patch meshtasticator lib/gui.py TkAgg->Agg before boot;
  probe readiness on the upstream host (docker daemon) when forwards are
  active; docker pull meshtastic/meshtasticd up front so the pull is off the
  simulator's node-boot path.
- e2e tests: cancel leftover loop tasks (watchdog) at loop teardown.
2026-09-07 21:33:49 -07:00
..
2026-09-07 21:01:21 -07:00

hermes-meshtastic

Meshtastic LoRa mesh gateway platform adapter plugin for Hermes Agent.

Allows bidirectional communication between Hermes AI agent profiles and off-grid Meshtastic nodes (e.g., Heltec V4, T-Beam, LilyGO) over 915 MHz LoRa mesh radio.

Features

  • Connects directly to local Meshtastic radio via TCP (e.g. meshtastic.local:4403).
  • Subscribes to LoRa text messages on designated channel index (e.g. Channel 1 # private with AES-256).
  • Direct Message (1-on-1) routing between Meshtastic Node IDs and Hermes agent sessions.
  • Automatic message chunking and markdown stripping to fit within LoRa RF packet budgets (<180 chars).
  • Automatic reconnection with exponential backoff.