meshtastic/plugin/README.md

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.