MESH-AI v0.5.1-beta- THE FIRST BETA RELEASE! #41

mr-tbot · 2025-07-28T15:34:37Z

mr-tbot
Jul 28, 2025
Maintainer

MESH-AI (BETA v0.5.1) - NOW IN BETA!

PLEASE NOTE - MESH-AI is out of ALPHA! There are new requirements and new config options! Old configs should work out of the box - but please see below for changes.

This release is functionally the same as v0.5.0 - but has been rebranded to MESH-AI for trademark compliance and respect for the official Meshtastic.org project. This project is getting a lot of attention now - and I am actively reaching out to the Meshtastic team for guidance on how to develop respectfully in their ecosystem - all previous ALPHA releases are going to be pulled from the repo.

MESH-AI is an experimental project that bridges Meshtastic LoRa mesh networks with powerful AI chatbots. This is the FIRST BETA RELEASE!

Disclaimer:
This project is NOT ASSOCIATED with the official Meshtastic Project. It is provided solely as an extension to add AI and advanced features to your Mesh network.

BETA Software Warning:
This version is still in BETA. It may be unstable or incomplete. Please avoid relying on it for mission‑critical tasks or emergencies. Always have backup communication methods available and use responsibly.

I am one robot using other robots to write this code. Some features are still untested in the field. Check the GitHub issues for fixes or feedback!

The Meshtastic logo trademark is the trademark of Meshtastic LLC.

Features

Multiple AI Providers
- Support for Local models (LM Studio, Ollama), OpenAI, and even Home Assistant integration.
Home Assistant Integration
- Seamlessly forward messages from a designated channel to Home Assistant’s conversation API. Optionally secure the integration using a PIN.
Advanced Slash Commands
- Built‑in commands: /about, /ping, /test, /help, /motd, /ai (aliases: /bot, /query, /data), /emergency (or /911), /whereami plus custom commands via commands_config.json.
- Commands are now case‑insensitive for improved mobile usability.
Emergency Alerts
- Trigger alerts that are sent via Twilio SMS, SMTP Email, and, if enabled, Discord.
- Emergency notifications include GPS coordinates, UTC timestamps, and user messages.
Enhanced REST API & WebUI Dashboard
- A modern three‑column layout showing broadcast messages, direct messages, and available nodes.
- Additional endpoints include /messages, /nodes, /connection_status, /logs, /send, /ui_send, and a new /discord_webhook for inbound Discord messages.
- UI customization through settings such as theme color, hue rotation, and custom sounds.
Improved Message Chunking & Routing
- Automatically splits long AI responses into configurable chunks with delays to reduce radio congestion.
- Configurable flags control whether the bot replies to broadcast channels and/or direct messages.
Robust Error Handling & Logging
- Uses UTC‑based timestamps with an auto‑truncating script log file (keeping the last 100 lines if the file grows beyond 100 MB).
- Enhanced error detection (including specific OSError codes) and graceful reconnection using threaded exception hooks.
Discord Integration Enhancements
- Route messages to and from Discord.
- New configuration options and a dedicated /discord_webhook endpoint allow for inbound Discord message processing.
Windows & Linux Focused
- Official support for Windows environments with installation guides; instructions for Linux available now - MacOS coming soon!

An example of an awesome Raspberry Pi 5 powered mini terminal - running MESH-AI & Ollama with HomeAssistant integration!

Top case model here by oinkers1: https://www.thingiverse.com/thing:6571150

Bottom Keyboard tray model here by mr_tbot: https://www.thingiverse.com/thing:7084222

Keyboard on Amazon here: https://a.co/d/2dAC9ph

Changelog

New Updates in v0.4.2 → v0.5.1 - NOW IN BETA!

REBRANDED TO MESH-AI
WebUI Enhancements
- Node Search added for easier node management.
- Channel Message Organization with support for custom channels in config.json.
- Revamped DM threaded messaging system.
- Location Links for nodes with available location data via Google Maps.
- Timezone Selection for accurate incoming message timestamps.
- Custom Local Sounds for message notifications (no longer relying on hosted files).
- Logs Page Auto-Refresh for live updates.
Baudrate Adjustment
- Configurable baud rate in config.json for longer USB connections (e.g., roof nodes).
LM Studio Model Selection
- Support for selecting models when multiple are loaded in LM Studio, enabling multi-model instances.
Protobuf Noise Debugging
- Moved any protobuf-related errors behind debug logs as they do not affect functionality.
- Can be enabled by setting "debug": true in config.json to track.
Updated Docker Support
- Updated Docker configuration to always pull/build the latest Meshtastic-Python libraries, ensuring compatibility with Protobuf versions.

POSSIBLE BUGS IN BETA v0.5.1 - Web UI ticker isn't honoring read messages in some cases.

INCOMING MESSAGE SOUNDS ARE UNTESTED ON ALL PLATFORMS AND FILESYSTEMS.

New Updates in v0.4.1 → v0.4.2

Initial Ubuntu & Ollama Unidecode Support: -
- User @milo_o - Thank you so much! I have merged your idea into the main branch - hoping this works as expected for users - please report any problems! - linux + ollama, decoding utf #19
Emergency Email Google Maps Link:
- Emergency email now includes a Google Maps link to the sender's location, rather than just coordinates. - Great call, @nlantz79! (Remember - this is only as accurate as the sender node's location precision allows!)

New Updates in v0.4.0 → v0.4.1

Error Handling (ongoing):
- Trying a new method to handle WinError exceptions - which though much improved in v0.4.0 - still occur under the right connection circumstances - especially over Wi-Fi.
  (UPDATE: My WinError issues were being caused by a combination of low solar power, and MQTT being enabled on my node. MQTT - especially using LongFast is very intense on a node, and can cause abrupt connection restarts as noted here: Add notes about public MQTT server having a lot of traffic meshtastic/meshtastic#901 - but - now the script is super robust regardless for handling errors!)
Emergency Email Subject:
- Email Subject now includes the long name, short name & Node ID of the sending node, rather than just the Node ID.
INITIAL Docker Support

New Updates in v0.3.0 → v0.4.0

Logging & Timestamps:
- Shift to UTC‑based timestamps and enhanced log management.
Discord Integration:
- Added configuration for inbound/outbound Discord message routing.
- Introduced a new /discord_webhook endpoint for processing messages from Discord.
Emergency Notifications:
- Expanded emergency alert logic to include detailed context (GPS data, UTC time) and Discord notifications.
Sending and receiving SMS:
- Send SMS using /sms <+15555555555> <message>
- Config options to either route incoming Twilio SMS messages to a specific node, or a channel index.
Command Handling:
- Made all slash commands case‑insensitive to improve usability.
- Enhanced custom command support via commands_config.json with dynamic AI prompt insertion.
Improved Error Handling & Reconnection:
- More granular detection of connection errors (e.g., specific OSError codes) and use of a global reset event for reconnects.
Code Refactoring:
- Overall code improvements for maintainability and clarity, with additional debug prints for troubleshooting.

Changelog: v0.2.2 → v0.3.0 (from the original Main Branch README)

WebUI Overhaul:
- Redesigned three‑column dashboard showing channel messages, direct messages, and node list.
- New send‑message form with toggleable modes (broadcast vs. direct), dynamic character counting, and message chunk preview.
Improved Error Handling & Stability:
- Redirected stdout/stderr to a persistent script.log file with auto‑truncation.
- Added a connection monitor thread to detect disconnections and trigger automatic reconnects.
- Implemented a thread exception hook for better error logging.
Enhanced Message Routing & AI Response Options:
- Added configuration flags (reply_in_channels and reply_in_directs) to control AI responses.
- Increased maximum message chunks (default up to 5) for longer responses.
- Updated slash command processing (e.g., added /about) and support for custom commands.
Expanded API Endpoints:
- New endpoints: /nodes, updated /connection_status, and /ui_send.
Additional Improvements:
- Robust Home Assistant integration and basic emergency alert enhancements.

1. Changelog: v0.1 → v0.2.2

Expanded Configuration & JSON Files
- New config.json fields
  - Added debug toggle for verbose debugging.
  - Added options for multiple AI providers (lmstudio, openai, ollama), including timeouts and endpoints.
  - Introduced Home Assistant integration toggles (home_assistant_enabled, home_assistant_channel_index, secure pin, etc.).
  - Implemented Twilio and SMTP settings for emergency alerts (including phone number, email, and credentials).
  - Added Discord webhook configuration toggles (e.g., enable_discord, discord_send_emergency, etc.).
  - Several new user-configurable parameters to control message chunking (chunk_size, max_ai_chunks, and chunk_delay) to reduce radio congestion.
Support for Multiple AI Providers
- Local Language Models (LM Studio, Ollama) and OpenAI (GPT-3.5, etc.) can be selected via ai_provider.
- Behavior is routed depending on which provider you specify in config.json.
Home Assistant Integration
- Option to route messages on a dedicated channel directly to Home Assistant’s conversation API.
- Security PIN requirement can be enabled, preventing unauthorized control of Home Assistant.
Improved Command Handling
- Replaced single-purpose code with a new, flexible commands system loaded from commands_config.json.
- Users can define custom commands that either have direct string responses or prompt an AI.
- Built-in commands now include /ping, /test, /emergency, /whereami, /help, /motd, and more.
Emergency Alert System
- /emergency (or /911) triggers optional Twilio SMS, SMTP email, and/or Discord alerts.
- Retrieves node GPS coordinates (if available) to include location in alerts.
Improved Message Chunking & Throttling
- Long AI responses are split into multiple smaller segments (configurable via chunk_size & max_ai_chunks).
- Delays (chunk_delay) between chunks to avoid flooding the mesh network.
REST API Endpoints (via built-in Flask server)
- GET /messages: Returns the last 100 messages in JSON.
- GET /dashboard: Displays a simple HTML dashboard showing the recently received messages.
- POST /send: Manually send messages to nodes (direct or broadcast) from external scripts or tools.
Improved Logging and File Structure
- messages.log for persistent logging of all incoming messages, commands, and emergencies.
- Distinct JSON config files: config.json, commands_config.json, and motd.json.
Refined Startup & Script Structure
- A new Run MESH-AI - Windows.bat script for straightforward Windows startup.
- Added disclaimers for alpha usage throughout the code.
- Streamlined reconnection and exception handling logic with more robust error-handling.
General Stability & Code Quality Enhancements
- Thorough refactoring of the code to be more modular and maintainable.
- Better debugging hooks, improved concurrency handling, and safer resource cleanup.

Quick Start (Windows)

Download/Clone
- Clone the repository or copy the mesh-ai folder to your Desktop. (Rename and remove "-main" tag from the folder name if downloading as ZIP)

Install Dependencies:

Create a virtual environment:

cd path\to\mesh-ai
python -m venv venv
venv\Scripts\activate

Upgrade pip and install required packages:

pip install --upgrade pip
pip install -r requirements.txt

Configure Files:
- Edit config.json, commands_config.json, and motd.json as needed. Refer to the Configuration section below.
Start the Bot:
- Run the bot by double‑clicking Run MESH-AI - Windows.bat or by executing:
```
python mesh-ai.py
```
Access the WebUI Dashboard:
- Open your browser and navigate to http://localhost:5000/dashboard.

Quick Start (Ubuntu / Linux)

Download/Clone
- Clone the repository or copy the mesh-ai folder to your preferred directory:
```
git clone https://github.com/mr-tbot/mesh-ai.git
cd mesh-ai
```
Create and Activate a Virtual Environment Named mesh-ai:
- Create the virtual environment:
```
python3 -m venv mesh-ai
```
- Activate the virtual environment:
```
source mesh-ai/bin/activate
```
Install Dependencies:
- Upgrade pip and install the required packages:
```
pip install --upgrade pip
pip install -r requirements.txt
```
Configure Files:
- Edit config.json, commands_config.json, and motd.json as needed. Refer to the Configuration section in the documentation for details.
Start the Bot:
- Run the bot by executing:
```
python mesh-ai.py
```
Access the WebUI Dashboard:
- Open your browser and navigate to http://localhost:5000/dashboard.

Quick Start (Docker)

Prerequisites
- Docker installed on your host (Linux, macOS, Windows or Raspberry Pi). (Current Images Built for Linux x86 & ARM64 Raspberry Pi)
- Docker support is currently untested on Windows & MacOS, and the Raspberry Pi image remains fresh and untested - please report back!
- A Meshtastic device connected via USB or WiFi (No Bluetooth testing Done as of yet)
- If needed,uncomment USB sections and set identifiers such as /dev/ttyUSB0 or \\.\COM3.
Prepare the Volume Structure
- In the root of your project directory:
- Extract the "docker-required-volumes.zip" - The included "config" & "logs" folders should be within your "mesh-ai folder"
- This file structure differs from the standard release to accommodate volumes for docker
- These files are placed in order to prevent docker from replacing these with directories on first start and throwing errors.
- Make any changes to config files as needed before moving forward.

File structure should look like this:

mesh-ai/
├── config/
│   ├── config.json
│   ├── commands_config.json
│   └── motd.json
└── logs/
 ├── script.log
 ├── messages.log
 └── messages_archive.json

Pull & run the Docker Image using docker-compose
- An example docker-compose-yaml is included in the github repository - please adjust as needed.
- From the project directory, run:
```
docker pull mrtbot/mesh-ai:latest
docker-compose up -d
```
Access the WebUI Dashboard:
- Open your browser and navigate to http://localhost:5000/dashboard.

Basic Usage

Interacting with the AI:
- Use /ai (or /bot, /query, /data) followed by your message to receive an AI response.
- For direct messages, simply DM the AI node if configured to reply.
Location Query:
- Send /whereami to retrieve the node’s GPS coordinates (if available).
Emergency Alerts:
- Trigger an emergency using /emergency <message> or /911 <message>.
  - These commands send alerts via Twilio, SMTP, and Discord (if enabled), including GPS data and timestamps.
Sending and receiving SMS:
- Send SMS using /sms <+15555555555> <message>
- Config options to either route incoming Twilio SMS messages to a specific node, or a channel index.
Home Assistant Integration:
- When enabled, messages sent on the designated Home Assistant channel (as defined by "home_assistant_channel_index") are forwarded to Home Assistant’s conversation API.
- In secure mode, include the PIN in your message (format: PIN=XXXX your message).
WebUI Messaging:
- Use the dashboard’s send‑message form to send broadcast or direct messages. The mode toggle and node selection simplify quick replies.

Using the API

The MESH-AI server (running on Flask) exposes the following endpoints:

GET /messages
Retrieve the last 100 messages in JSON format.
GET /nodes
Retrieve a live list of connected nodes as JSON.
GET /connection_status
Get current connection status and error details.
GET /logs
View a styled log page showing uptime, restarts, and recent log entries.
GET /dashboard
Access the full WebUI dashboard.
POST /send and POST /ui_send
Send messages programmatically.
POST /discord_webhook
Receive messages from Discord (if configured).

Configuration

Your config.json file controls almost every aspect of MESH-AI. Below is an example configuration that includes both the previous settings and the new options:

{
  "debug": false, 
  "use_mesh_interface": false,  // Set to true if using the Meshtastic mesh interface instead of WiFi
  "use_wifi": true,  // Set to false if using a serial connection instead of WiFi
  "wifi_host": "MESHTASTIC NODE IP HERE",  // IP address of your Meshtastic device if using WiFi
  "wifi_port": 4403,  // Default port for WiFi connection
  
  "serial_port": "",  // Set the serial port if using a USB connection (e.g., /dev/ttyUSB0 on Linux or COMx on Windows)
  // "serial_baud": 460800,  // Set baud rate for long USB runs or subpar USB connections (uncomment to use)

  "ai_provider": "lmstudio, openai, or ollama",  // Select the AI provider: "lmstudio", "openai", or "ollama"
  "system_prompt": "You are a helpful assistant responding to mesh network chats. Respond in as few words as possible while still answering fully.",  // System prompt for AI interaction

  "lmstudio_url": "http://localhost:1234/v1/chat/completions",  // URL for LM Studio's API
  // "lmstudio_chat_model": "MODEL IDENTIFIER HERE",  // LM Studio chat model (uncomment and specify if using LM Studio)
  // "lmstudio_embedding_model": "TEXT EMBEDDING MODEL IDENTIFIER HERE",  // LM Studio embedding model (uncomment and specify if using LM Studio)
  "lmstudio_timeout": 60,  // Timeout in seconds for LM Studio API requests

  "openai_api_key": "",  // API key for OpenAI (leave empty if not using OpenAI)
  "openai_model": "gpt-4.1-mini",  // OpenAI model to use (e.g., "gpt-4.1-mini" or "gpt-3.5-turbo")
  "openai_timeout": 60,  // Timeout in seconds for OpenAI API requests

  "ollama_url": "http://localhost:11434/api/generate",  // URL for Ollama's API
  "ollama_model": "llama3",  // Ollama model (e.g., "llama3")
  "ollama_timeout": 60,  // Timeout in seconds for Ollama API requests

  "home_assistant_url": "http://homeassistant.local:8123/api/conversation/process",  // Home Assistant API URL for conversation processing
  "home_assistant_token": "INPUT HA TOKEN HERE",  // Home Assistant API token (replace with your token)
  "home_assistant_timeout": 90,  // Timeout in seconds for Home Assistant API requests
  "home_assistant_enable_pin": false,  // Set to true to require a PIN for Home Assistant commands
  "home_assistant_secure_pin": "1234",  // PIN for Home Assistant (if enabled)

  "home_assistant_enabled": false,  // Set to true to enable Home Assistant integration
  "home_assistant_channel_index": 1,  // Index of the channel for Home Assistant messages (set to -1 if not using)

  "channel_names": {
    "0": "LongFast",  // Name for Channel 0
    "1": "Channel 1",  // Name for Channel 1
    "2": "Channel 2",  // Name for Channel 2
    "3": "Channel 3",  // Name for Channel 3
    "4": "Channel 4",  // Name for Channel 4
    "5": "Channel 5",  // Name for Channel 5
    "6": "Channel 6",  // Name for Channel 6
    "7": "Channel 7",  // Name for Channel 7
    "8": "Channel 8",  // Name for Channel 8
    "9": "Channel 9"   // Name for Channel 9
  },
  
  "reply_in_channels": true,  // Set to true to allow AI to reply in broadcast channels
  "reply_in_directs": true,  // Set to true to allow AI to reply in direct messages
  
  "chunk_size": 200,  // Maximum size for message chunks
  "max_ai_chunks": 5,  // Maximum number of chunks to split AI responses into
  "chunk_delay": 10,  // Delay between message chunks to reduce congestion
  
  "local_location_string": "@ YOUR LOCATION HERE",  // Local string for your node's location (e.g., "@ Home", "@ Roof Node")
  "ai_node_name": "Mesh-AI-Alpha",  // Name for your AI node
  "max_message_log": 0,  // Set the maximum number of messages to log (set to 0 for unlimited)

  "enable_twilio": false,  // Set to true to enable Twilio for emergency alerts via SMS
  "enable_smtp": false,  // Set to true to enable SMTP for emergency alerts via email
  "alert_phone_number": "+15555555555",  // Phone number to send emergency SMS alerts to (Twilio)
  "twilio_sid": "TWILIO_SID",  // Twilio SID (replace with your SID)
  "twilio_auth_token": "TWILIO_AUTH_TOKEN",  // Twilio Auth Token (replace with your Auth Token)
  "twilio_from_number": "+14444444444",  // Twilio phone number to send messages from

  "smtp_host": "SMTP HOST HERE",  // SMTP server hostname (e.g., smtp.gmail.com)
  "smtp_port": 465,  // SMTP server port (465 for SSL, or 587 for TLS)
  "smtp_user": "SMTP USER HERE",  // SMTP username (usually your email address)
  "smtp_pass": "SMTP PASS HERE",  // SMTP password (use app-specific passwords if necessary)
  "alert_email_to": "ALERT EMAIL HERE",  // Email address to send emergency alerts to

  "enable_discord": false,  // Set to true to enable Discord integration for emergency alerts and AI responses
  "discord_webhook_url": "",  // Discord Webhook URL (for sending messages to Discord)
  "discord_send_emergency": false,  // Set to true to send emergency alerts to Discord
  "discord_send_ai": false,  // Set to true to send AI responses to Discord
  "discord_send_all": false  // Set to true to send all messages to Discord
}

Home Assistant & LLM API Integration

Home Assistant Integration

Enable Integration:
- Set "home_assistant_enabled": true in config.json.
Configure:
- Set "home_assistant_url" (e.g., http://homeassistant.local:8123/api/conversation/process).
- Provide "home_assistant_token" and adjust "home_assistant_timeout".
Security (Optional):
- Enable "home_assistant_enable_pin": true and set "home_assistant_secure_pin".
Routing:
- Messages on the channel designated by "home_assistant_channel_index" are forwarded to Home Assistant.
- When PIN mode is enabled, include your PIN in the format PIN=XXXX your message.

LLM API Integration

LM Studio:
- Set "ai_provider": "lmstudio" and configure "lmstudio_url". - optionally set model and text embedding flags as well if using more than one model on the same LM-Studio instance.
OpenAI:
- Set "ai_provider": "openai", provide your API key in "openai_api_key", and choose a model.
Ollama:
- Set "ai_provider": "ollama" and configure the corresponding URL and model.

Communication Integrations

Email Integration

Enable Email Alerts:
- Set "enable_smtp": true in config.json.
Configure SMTP:
- Provide the following settings in config.json:
  - "smtp_host" (e.g., smtp.gmail.com)
  - "smtp_port" (use 465 for SSL or another port for TLS)
  - "smtp_user" (your email address)
  - "smtp_pass" (your email password or app-specific password)
  - "alert_email_to" (recipient email address or list of addresses)
Behavior:
- Emergency emails include a clickable Google Maps link (generated from available GPS data) so recipients can quickly view the sender’s location.
Note:
- Ensure your SMTP settings are allowed by your email provider (for example, Gmail may require an app password and proper security settings).

Discord Integration: Detailed Setup & Permissions

1. Create a Discord Bot

Access the Developer Portal:
Go to the Discord Developer Portal and sign in with your Discord account.
Create a New Application:
Click on "New Application," give it a name (e.g., MESH-AI Bot), and confirm.
Add a Bot to Your Application:
- Select your application, then navigate to the Bot tab on the left sidebar.
- Click on "Add Bot" and confirm by clicking "Yes, do it!"
- Customize your bot’s username and icon if desired.

2. Set Up Bot Permissions

Required Permissions:
Your bot needs a few basic permissions to function correctly:
- View Channels: So it can see messages in the designated channels.
- Send Messages: To post responses and emergency alerts.
- Read Message History: For polling messages from a channel (if polling is enabled).
- Manage Messages (Optional): If you want the bot to delete or manage messages.
Permission Calculator:
Use a tool like Discord Permissions Calculator to generate the correct permission integer.
For minimal functionality, a permission integer of 3072 (which covers "Send Messages," "View Channels," and "Read Message History") is often sufficient.

3. Invite the Bot to Your Server

Generate an Invite Link:
Replace YOUR_CLIENT_ID with your bot’s client ID (found in the General Information tab) in the following URL:
```
https://discord.com/api/oauth2/authorize?client_id=YOUR_CLIENT_ID&permissions=3072&scope=bot
```
Invite the Bot:
Open the link in your browser, select the server where you want to add the bot, and authorize it. Make sure you have the “Manage Server” permission in that server.

4. Configure Bot Credentials in `config.json`

Update your configuration file with the following keys (replace placeholder text with your actual values):

{
  "enable_discord": true,
  "discord_webhook_url": "YOUR_DISCORD_WEBHOOK_URL",
  "discord_receive_enabled": true,
  "discord_bot_token": "YOUR_BOT_TOKEN",
  "discord_channel_id": "YOUR_CHANNEL_ID",
  "discord_inbound_channel_index": 1,  // or the channel number you prefer
  "discord_send_ai": true,
  "discord_send_emergency": true
}

discord_webhook_url:
Create a webhook in your desired Discord channel (Channel Settings → Integrations → Webhooks) and copy its URL.
discord_bot_token & discord_channel_id:
Copy your bot’s token from the Developer Portal and enable message polling by specifying the channel ID where the bot should read messages.
To get a channel ID, enable Developer Mode in Discord (User Settings → Advanced → Developer Mode) then right-click the channel and select "Copy ID."

5. Polling Integration (Optional)

Enable Message Polling:
Set "discord_receive_enabled": true to allow the bot to poll for new messages.
Routing:
The configuration key "discord_inbound_channel_index" determines the channel number used by MESH-AI for routing incoming Discord messages. Make sure it matches your setup.

6. Testing Your Discord Setup

Restart MESH-AI:
With the updated configuration, restart your bot.
Check Bot Activity:
Verify that the bot is present in your server, that it can see messages in the designated channel, and that it can send responses.
Emergency Alerts & AI Responses:
Confirm that emergency alerts and AI responses are being posted in Discord as per your configuration ("discord_send_ai": true and "discord_send_emergency": true).

7. Troubleshooting Tips

Permissions Issues:
If the bot isn’t responding or reading messages, double-check that its role on your server has the required permissions.
Channel IDs & Webhook URLs:
Verify that you’ve copied the correct channel IDs and webhook URLs (ensure no extra spaces or formatting issues).
Bot Token Security:
Keep your bot token secure. If it gets compromised, regenerate it immediately from the Developer Portal.

Twilio Integration

Enable Twilio:
- Set "enable_twilio": true in config.json.
Configure Twilio Credentials:
- Provide your Twilio settings in config.json:
  - "twilio_sid": "YOUR_TWILIO_SID"
  - "twilio_auth_token": "YOUR_TWILIO_AUTH_TOKEN"
  - "twilio_from_number": "YOUR_TWILIO_PHONE_NUMBER"
  - "alert_phone_number": "DESTINATION_PHONE_NUMBER" (the number to receive emergency SMS)
Usage:
- When an emergency is triggered, the bot sends an SMS containing the alert message (with a Google Maps link if GPS data is available).
Tip:
- Follow Twilio's setup guide to obtain your SID and Auth Token, and ensure that your phone numbers are verified.

Other Important Settings

Logging & Archives:
- Script logs are stored in script.log and message logs in messages.log.
- An archive is maintained in messages_archive.json to keep recent messages.
Device Connection:
- Configure the connection method for your Meshtastic device by setting either the "serial_port" or enabling "use_wifi" along with "wifi_host" and "wifi_port".
- Alternatively, enable "use_mesh_interface" if applicable.
- Baud Rate is optionally set if you need - this is for longer USB runs (roof nodes connected via USB) and bad USB connections.
Message Routing & Commands:
- Custom commands can be added in commands_config.json.
- The WebUI Dashboard (accessible at http://localhost:5000/dashboard) displays messages and node status.
AI Provider Settings:
- Adjust "ai_provider" and related API settings (timeouts, models, etc.) for LM Studio, OpenAI, Ollama, or Home Assistant integration.
Security:
- If using Home Assistant with PIN protection, follow the specified format (PIN=XXXX your message) to ensure messages are accepted.
Testing:
- You can test SMS sending with the /sms command or trigger an emergency alert to confirm that Twilio and email integrations are functioning.

Contributing & Disclaimer

Alpha Software Notice:
This release (v0.4.2) is experimental. Expect bugs and changes that might affect existing features. Thorough field testing is recommended before production use.
Feedback & Contributions:
Report issues or submit pull requests on GitHub. Your input is invaluable.
Use Responsibly:
Modifying this code for nefarious purposes is strictly prohibited. Use at your own risk.

Donations are GRACIOUSLY accepted to stoke development!

PayPal:
https://www.paypal.com/ncp/payment/XPW23EP9XHMYS
BTC:
bc1qcfstyxaktw5ppnsm5djmpvmgv49z0cp6df33tl
XRP:
TrpgvB8EgTtqhU1W6XJAvx3CS8KKkRwTLHc
DOGE:
D5MyXVRkwLW9XzcKjjcwEHcXvnaTFueZhy

Conclusion

MESH-AI BETA v0.5.1 takes the solid foundation of v0.4.2 and introduces even more significant improvements in logging, error handling, and a bit of polish on the web-UI and it's function. Whether you’re chatting directly with your node, integrating with Home Assistant, or leveraging multi‑channel alerting (Twilio, Email, Discord), this release offers a more comprehensive and reliable off‑grid AI assistant experience.

Enjoy tinkering, stay safe, and have fun!
Please share your feedback or join our community on GitHub.

This discussion was created from the release MESH-AI v0.5.1-beta- THE FIRST BETA RELEASE!.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

MESH-AI v0.5.1-beta- THE FIRST BETA RELEASE! #41

Uh oh!

{{title}}

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

MESH-AI v0.5.1-beta- THE FIRST BETA RELEASE! #41

Uh oh!

mr-tbot Jul 28, 2025 Maintainer

MESH-AI (BETA v0.5.1) - NOW IN BETA!

Features

Changelog

New Updates in v0.4.2 → v0.5.1 - NOW IN BETA!

POSSIBLE BUGS IN BETA v0.5.1 - Web UI ticker isn't honoring read messages in some cases.

INCOMING MESSAGE SOUNDS ARE UNTESTED ON ALL PLATFORMS AND FILESYSTEMS.

New Updates in v0.4.1 → v0.4.2

New Updates in v0.4.0 → v0.4.1

New Updates in v0.3.0 → v0.4.0

Changelog: v0.2.2 → v0.3.0 (from the original Main Branch README)

1. Changelog: v0.1 → v0.2.2

Quick Start (Windows)

Quick Start (Ubuntu / Linux)

Quick Start (Docker)

Basic Usage

Using the API

Configuration

Home Assistant & LLM API Integration

Home Assistant Integration

LLM API Integration

Communication Integrations

Email Integration

Discord Integration: Detailed Setup & Permissions

1. Create a Discord Bot

2. Set Up Bot Permissions

3. Invite the Bot to Your Server

4. Configure Bot Credentials in config.json

5. Polling Integration (Optional)

6. Testing Your Discord Setup

7. Troubleshooting Tips

Twilio Integration

Other Important Settings

Contributing & Disclaimer

Donations are GRACIOUSLY accepted to stoke development!

Conclusion

Replies: 0 comments

mr-tbot
Jul 28, 2025
Maintainer

4. Configure Bot Credentials in `config.json`