Repolode
Submit
SpudGunMan

SpudGunMan/meshing-around

A Python bot for Meshtastic mesh networks that handles network testing, BBS-style messaging, games, alerts and data lookups over text messages.

View on GitHub
Stars
543
Forks
82
Open issues
14
Last commit
7 days ago

What is it?

Mesh Bot is a Python bot for Meshtastic, a long-range radio mesh network. It runs on a node or a computer connected to a Meshtastic device and responds to text commands sent over the mesh, so users can test links, leave mail for other nodes, play text games and look up data without a phone app or internet connection.

The bot includes a keyword responder (for example replying "pong" to "ping"), mail and store-and-forward messaging, a message scheduler, and BBS linking between multiple bots. Data features cover NOAA and USGS weather, earthquake and tide information, Wikipedia and Kiwix lookups, satellite passes and Ollama-based LLM replies. Alert features include FEMA, NOAA and USGS emergency feeds, proximity alerts, file monitoring, and radio monitoring through Hamlib, WSJT-X and JS8Call.

The project is developed mainly on Linux and a Raspberry Pi, and includes an install script and Docker setup. Its configuration is handled through a config file and module guides.

Key features

  • 01Keyword auto-replies and custom triggers in DMs and group channels
  • 02Mail and store-and-forward messaging between nodes, with BBS linking
  • 03Weather, earthquake, tide and river data from NOAA, USGS and Open-Meteo
  • 04Emergency alerts from FEMA, NOAA, USGS and other feeds
  • 05Built-in text games such as BlackJack and Lemonade Stand
  • 06Radio monitoring through Hamlib, WSJT-X and JS8Call

Use cases

  • Testing message delivery and hardware limits on a Meshtastic network
  • Running a community BBS or message board over a off-grid mesh
  • Sending emergency and weather alerts to mesh users during events
  • Tracking site locations or assets with GPS-logged map entries

Quick start

  1. 1

    Clone the repository from GitHub

    git clone https://github.com/spudgunman/meshing-around
  2. 2

    Run the automated installation script (install.sh) to set up the venv and requirements

  3. 3

    Follow the Configuration Guide to set up your Meshtastic device and bot settings

Things to know

  • Requires Meshtastic-compatible hardware to connect to a mesh network.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to be open-sourced under the same terms.
  • Developed and tested primarily on Linux (Raspberry Pi); other platforms are less proven.

In collections

AI chatbots & chat clients

Topics

#meshtastic#lora#bbs#chatbot#iot#radio#emergency-alerts#python

FAQ

What is meshing-around?
A Python bot for Meshtastic mesh networks that handles network testing, BBS-style messaging, games, alerts and data lookups over text messages. Mesh Bot is a Python bot for Meshtastic, a long-range radio mesh network. It runs on a node or a computer connected to a Meshtastic device and responds to text commands sent over the mesh, so users can test links, leave mail for other nodes, play text games and look up data without a phone app or internet connection.
Is meshing-around free to use? What license does it have?
meshing-around is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is meshing-around still maintained?
Actively maintained. The last commit to meshing-around was on Oct 31, 2026.
What can I use meshing-around for?
Testing message delivery and hardware limits on a Meshtastic network Running a community BBS or message board over a off-grid mesh Sending emergency and weather alerts to mesh users during events Tracking site locations or assets with GPS-logged map entries
How do I install meshing-around?
Clone the repository from GitHub: git clone https://github.com/spudgunman/meshing-around Run the automated installation script (install.sh) to set up the venv and requirements Follow the Configuration Guide to set up your Meshtastic device and bot settings
Where can I get meshing-around?
The source code and installation instructions are on GitHub: https://github.com/SpudGunMan/meshing-around

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects