Sign inSign up

mrtbot/mesh-ai

By mrtbot

•Updated about 1 year ago

MESH-AI is an experimental project that bridges Meshtastic LoRa mesh networks with AI chatbots.

Image
Networking
Internet of things
Machine learning & AI
1

3.9K

mrtbot/mesh-ai repository overview

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

(For detailed changelogs and installation instructions - visit https://mesh-ai.dev⁠ or https://github.com/mr-tbot/mesh-ai⁠)

  • 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

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!

image 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!

Tag summary

Content type

Image

Digest

sha256:6f137a580…

Size

281.7 MB

Last updated

about 1 year ago

docker pull mrtbot/mesh-ai