From dbc07880ee74ea18de7f5cea9362714ef102d292 Mon Sep 17 00:00:00 2001 From: agessaman Date: Sat, 25 Apr 2026 19:11:27 -0700 Subject: [PATCH] docs(README): add caution section regarding bot installation and mesh congestion - Introduced a cautionary note in the README to advise users on the potential issues of adding multiple bots to a mesh network. - Highlighted the risks of congestion and double responses when running more than one bot on a single channel. - Suggested best practices for managing bots, including the use of regions or hop limits. --- README.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/README.md b/README.md index 37673d7..ca4c861 100644 --- a/README.md +++ b/README.md @@ -2,6 +2,15 @@ A Python bot that connects to MeshCore mesh networks via serial port, BLE, or TCP/IP. The bot responds to messages containing configured keywords, executes commands, and provides various data services including weather, solar conditions, and satellite pass information. A web viewer provides a browser-based dashboard for monitoring and managing the bot. +## Caution + +> [!CAUTION] +> Before installing this bot, please take a moment to _truly_ consider if your mesh needs another bot. If there are already several bots on your mesh, it is likely that you are adding congestion without adding value. +> +> It is not recommended to run more than one bot on a single channel. Adding another bot to a channel already in use on your mesh may result in users unnecessarily receiving double responses, depleting mesh airtime for little additional value. +> +> If you decide to run the bot on your mesh, please take advantage of regions or hop limits to ensure that your bot is helping your neighbors not flooding the entire mesh. + ## Features - **Connection Methods**: Serial port, BLE (Bluetooth Low Energy), or TCP/IP