From 05a8f8659d4e2bc45cacd96b15d0f4858fbbd036 Mon Sep 17 00:00:00 2001 From: Ubuntu Date: Mon, 23 Feb 2026 21:29:59 +0000 Subject: [PATCH] Document advBBS compatibility in README Co-Authored-By: Claude Opus 4.6 --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index a9350fa..2562591 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,7 @@ LLM-powered assistant for Meshtastic mesh networks. - **Conversation History**: Per-user context maintained in SQLite - **Smart Chunking**: Automatically splits long responses for mesh transmission - **Rate Limiting**: Configurable delays to avoid flooding the mesh +- **advBBS Compatible**: Runs alongside [advBBS](https://github.com/NovaNexusMesh/advBBS) on the same node — protocol sync messages and mail notifications are automatically filtered - **Rich Configurator**: Interactive TUI for easy setup ## Installation @@ -188,6 +189,24 @@ LLM_API_KEY=your-key-here docker compose logs -f meshai ``` +## Running Alongside advBBS + +MeshAI is designed to coexist with [advBBS](https://github.com/NovaNexusMesh/advBBS) on the same Meshtastic node. Both connect via TCP to meshtasticd and share the radio, but MeshAI automatically ignores advBBS traffic: + +- **Sync protocol** — `MAILREQ|`, `MAILACK|`, `MAILDAT|`, `BOARDREQ|`, etc. +- **RAP protocol** — `advBBS|` pings, pongs, and route advertisements +- **Mail notifications** — `[MAIL]` new message alerts +- **Bang commands in DMs** — `!mail`, `!board`, etc. are left for advBBS to handle + +No special configuration is needed. The filter is enabled by default and can be toggled in `config.yaml`: + +```yaml +bot: + filter_bbs_protocols: true # set false to disable +``` + +Plain-text BBS responses (e.g. "Welcome back, matt!") are indistinguishable from normal user messages and will be processed normally — this is a known and accepted limitation. + ## Running as a Service Create `/etc/systemd/system/meshai.service`: