๐ท MeshPi
Zero-Touch Raspberry Pi Fleet Management
๐ Configure WiFi, SSH, users, hardware peripherals, and manage devices through encrypted mesh networking
Install โข Quick Start โข Features โข Docs โข PyPI
๐๏ธ Architektura Systemu
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ MESHPI FLEET MANAGEMENT โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ GRUPY RPi โโโโโถโ PROFILE HW โโโโโถโ INSTALACJA โโโโโถโ MONITORING โ
โ โ โ โ โ โ โ โ
โ โข office_sensorsโ โ โข OS + Drivers โ โ โข Pakiety โ โ โข Prometheus โ
โ โข warehouse_autoโ โ โข Biblioteki โ โ โข Moduลy โ โ โข Grafana โ
โ โข lab_gpio โ โ โข Konfiguracja โ โ โข Uprawnienia โ โ โข Alerting โ
โ โข home_automationโ โ โ โ โ โ โข Audit Logs โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ โ โ โ
โผ โผ โผ โผ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ LOGIKA โ โ KONFIGURACJA โ โ DEPLOYMENT โ โ OBSERWOWALNOลฤโ
โ โ โ โ โ โ โ โ
โ โข Logiczne โ โ โข YAML profiles โ โ โข SSH Remote โ โ โข Real-time โ
โ โข Zbiory โ โ โข Kategorie โ โ โข Batch Install โ โ โข Historical โ
โ โข Przeznaczenie โ โ โข Tagi โ โ โข OTA Updates โ โ โข Alerting โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฅ FLOW PRACY MESHPI โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ
โ PLAN โโโโโถโ KONFIG โโโโโถโ WYBรR โโโโโถโ INSTAL โโโโโถโ MONITOR โ
โ โ โ โ โ โ โ โ โ โ
โ Grupy โ โ Urzฤ
dz. โ โ Profile โ โ Pakiety โ โ Metryki โ
โ Profile โ โ SSH โ โ Hardwareโ โ Moduลy โ โ Alerty โ
โ Scenarizโ โ Sieฤ โ โ Drivers โ โ Uprawn. โ โ Logs โ
โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ข TYPOWE WDROลปENIE - BIURO โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ
โ HOST PC โ โโโถ meshpi host (port 7422)
โ 192.168.1.10 โ
โโโโโโโโโโโโโโโโโโโ
โ
โผ SSH + ENCRYPTION
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ RPi #1 โ โ RPi #2 โ โ RPi #3 โ
โ 192.168.1.100 โ โ 192.168.1.101 โ โ 192.168.1.102 โ
โ โ โ โ โ โ
โ โข BME280 Sensor โ โ โข BME280 Sensor โ โ โข BME280 Sensor โ
โ โข OLED Display โ โ โข OLED Display โ โ โข OLED Display โ
โ โข WiFi Config โ โ โข WiFi Config โ โ โข WiFi Config โ
โ โข SSH Keys โ โ โข SSH Keys โ โ โข SSH Keys โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ โ โ
โผ โผ โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ PROMETHEUS + GRAFANA โ
โ โ
โ โข CPU/Memory/Temperature Metrics โ
โ โข Sensor Data (temp/humidity/pressure) โ
โ โข Device Status & Health โ
โ โข Alert Rules (offline, high temp, low memory) โ
โ โข Historical Data & Trends โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ Overview
MeshPi eliminates the manual work of configuring Raspberry Pi devices from factory defaults. Whether deploying one device or an entire fleet, MeshPi handles:
- ๐ถ WiFi credentials - No monitor/keyboard needed
- ๐ SSH keys - Secure remote access out of the box
- ๐ค User accounts - Create users, set passwords
- ๐ Locale & timezone - Regional settings applied automatically
- ๐ง Hardware peripherals - 49+ profiles for displays, sensors, GPIO devices
- ๐ Real-time monitoring - CPU, memory, temperature, network status
- ๐ค LLM-powered management - Natural language fleet commands
All secured with RSA-2048 + AES-256-GCM encryption. No credentials ever travel in plaintext.
โก Quick Start
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ QUICK START FLOW โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ HOST PC โ โ MESHPI HOST โ โ CLIENT RPi โ
โ โ โ โ โ โ
โ โข Install MeshPiโ โโโถ โ โข Config Wizard โ โโโถ โ โข Scan & Join โ
โ โข Run Config โ โ โข Start Service โ โ โข Auto-Setup โ
โ โข Start Host โ โ โข Port 7422 โ โ โข Reboot Ready โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
# Install
pip install meshpi
# On HOST machine (your PC or a dedicated RPi)
meshpi config # Interactive configuration wizard
meshpi host # Start the host service
# On each CLIENT Raspberry Pi (fresh from factory)
meshpi scan # Auto-discovers host, configures itself, reboots
๐ฏ Done! Your Raspberry Pi is now configured and ready.
๐ฑ Client Setup (Raspberry Pi)
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฑ RASPBERRY PI SETUP FLOW โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ FACTORY RPi โโโโโถโ CONNECT NET โโโโโถโ UPDATE SYSTEM โโโโโถโ SCAN & JOIN โ
โ โ โ โ โ โ โ โ
โ โข Fresh OS โ โ โข WiFi/Network โ โ โข apt update โ โ โข meshpi scan โ
โ โข Default Configโ โ โข Internet โ โ โข apt upgrade โ โ โข Auto-discover โ
โ โข No Config โ โ โข Access โ โ โข reboot โ โ โข Auto-setup โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
๐ง Prerequisites Setup
Before running meshpi scan on your Raspberry Pi, follow these steps:
1. Connect to Internet
# Connect to WiFi using desktop interface or command line
sudo raspi-config
# Navigate to Network Options โ Wi-Fi โ Enter SSID and password
2. Update System
# Update package lists and upgrade system packages
sudo apt update && sudo apt upgrade -y
# Reboot after updates
sudo reboot
3. Install Python pip
# Install pip if not already installed
sudo apt install python3-pip python3-venv -y
# Verify installation
pip3 --version
4. Install MeshPi
# Install MeshPi package
pip3 install meshpi
# Or with LLM support for natural language commands
pip3 install "meshpi[llm]"
5. Run MeshPi Scan
# Discover and connect to MeshPi host
meshpi scan
๐ One-Liner Installation
For experienced users, here's the complete setup in one command:
sudo apt update && sudo apt upgrade -y && sudo apt install python3-pip -y && pip3 install meshpi && meshpi scan
๐ What Happens During Scan
When you run meshpi scan, the client will:
- ๐ Discover Host - Uses mDNS to find MeshPi hosts on your network
- ๐ Key Exchange - Generates RSA key pair and exchanges with host
- ๐ Download Config - Receives encrypted configuration
- โ๏ธ Apply Settings - Configures WiFi, SSH, users, locale
- ๐ Reboot - Restarts to apply all changes
๐ ๏ธ Troubleshooting
No hosts found?
- Ensure host machine is running
meshpi host - Check both devices are on the same network
- Verify firewall allows mDNS (port 5353)
Installation issues?
# Update pip to latest version
pip3 install --upgrade pip
# Install with specific version
pip3 install meshpi==0.1.14
โจ Features
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ฅ MESHPI FEATURE MATRIX โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ ENCRYPTION โ โ FLEET MGMT โ โ HARDWARE โ โ MONITORING โ
โ โ โ โ โ โ โ โ
โ โข RSA-2048 โ โ โข WebSocket โ โ โข 49+ Profiles โ โ โข Prometheus โ
โ โข AES-256-GCM โ โ โข Real-time โ โ โข Group Mgmt โ โ โข Grafana โ
โ โข mDNS Discoveryโ โ โข Push Updates โ โ โข Auto-Install โ โ โข Alerting โ
โ โข Zero-Touch โ โ โข Remote CMD โ โ โข Custom Config โ โ โข Audit Logs โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
๐ Encrypted Zero-Touch Provisioning
- RSA-2048 key exchange + AES-256-GCM encryption
- No shared secrets, no cleartext on the wire
- mDNS discovery for automatic host detection
๐ก Real-Time Fleet Management
- WebSocket-based persistent connections
- Push config updates instantly
- Execute shell commands remotely
- Apply hardware profiles on-the-fly
- Trigger reboots with delay
๐ง 49+ Hardware Profiles with Group Management
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ ๏ธ HARDWARE PROFILES CATALOG โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ DISPLAYS โ โ SENSORS โ โ MOTORS โ โ HATs โ
โ โ โ โ โ โ โ โ
โ โข OLED SSD1306 โ โ โข BME280 โ โ โข A4988 Stepper โ โ โข Sense HAT โ
โ โข TFT ILI9341 โ โ โข DS18B20 โ โ โข PCA9685 Servo โ โ โข PiSugar UPS โ
โ โข e-Paper โ โ โข MPU-6050 โ โ โข DC Motors โ โ โข RTC DS3231 โ
โ โข HDMI 4K โ โ โข INA219 โ โ โข Relays โ โ โข Adafruit HAT โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ CAMERAS โ โ AUDIO โ โ NETWORKING โ โ GPIO โ
โ โ โ โ โ โ โ โ
โ โข RPi Camera v2 โ โ โข HiFiBerry DAC โ โ โข CAN Bus โ โ โข Distance โ
โ โข USB UVC โ โ โข I2S Microphoneโ โ โข RS-485 โ โ โข Ultrasonic โ
โ โข IR NightVisionโ โ โข PWM Speakers โ โ โข LoRa โ โ โข IR Sensors โ
โ โข MIPI CSI โ โ โข Bluetooth โ โ โข nRF24L01 โ โ โข Touch Sensors โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
| Category | Examples |
|---|---|
| ๐ฅ๏ธ Display | OLED SSD1306, TFT ILI9341, e-Paper, HDMI 4K |
| ๐๏ธ GPIO | Steppers (A4988), relays, servos (PCA9685), distance sensors |
| ๐ก๏ธ Sensors | BME280, DS18B20, MPU-6050, INA219 |
| ๐ท Camera | RPi Camera v2/HQ, USB UVC, IR night vision |
| ๐ Audio | HiFiBerry DAC+, I2S MEMS microphone |
| ๐ก Networking | CAN, RS-485, LoRa, nRF24L01 |
| ๐ฉ HATs | Sense HAT, PiSugar UPS, RTC DS3231 |
# Quick interactive installation
meshpi hw quick-install --interactive
# Browse hardware catalog
meshpi hw catalog --category sensor --popular
# Apply to device groups
meshpi group create sensors
meshpi group add-device sensors pi@192.168.1.100
meshpi group hw-apply sensors sensor_bme280 sensor_ds18b20
# Remote management via SSH
meshpi ssh hw-apply --target pi@192.168.1.100 hat_sense
meshpi ssh hw-search oled --category display
New Features:
- ๐ฏ Quick Install Wizard - Interactive hardware selection and installation
- ๐ Hardware Catalog - Browse and filter 49+ profiles with tags
- ๐ฅ Device Groups - Batch operations on multiple devices
- ๐ SSH Remote Management - Control hardware on remote devices
- ๐จ Custom Profiles - Create and share your own hardware configurations
๐ค LLM-Powered Agent
pip install "meshpi[llm]"
meshpi agent
> show me all online devices
> what's wrong with rpi-kitchen?
> enable OLED display on rpi-bedroom
> push new WiFi password to all devices
Works with OpenAI, Anthropic, Ollama (local), Azure, Groq, and more.
๐ Full Diagnostics
meshpi diag
Collects CPU load, memory, temperature, GPIO states, I2C scan, USB devices, WiFi signal, services, logs, and more.
๐ Monitoring & Observability
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ MESHPI MONITORING STACK โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ AUDIT LOGS โ โ PROMETHEUS โ โ ALERT ENGINE โ โ GRAFANA โ
โ โ โ โ โ โ โ โ
โ โข JSONL Format โ โ โข Metrics API โ โ โข 9 Rules โ โ โข Dashboards โ
โ โข Operations โ โ โข Time Series โ โ โข Temperature โ โ โข Visualization โ
โ โข Device Events โ โ โข Device Health โ โ โข Memory โ โ โข Historical โ
โ โข Timestamps โ โ โข System Stats โ โ โข Offline โ โ โข Alerting โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ โ โ โ
โผ โผ โผ โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ CENTRALIZED MONITORING โ
โ โ
โ โข Real-time Metrics Collection โ
โ โข Historical Data Storage โ
โ โข Alert Notifications โ
โ โข Visual Dashboards โ
โ โข Fleet Health Overview โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
MeshPi includes built-in monitoring with Prometheus metrics, alerting, and audit logging:
# View audit log
meshpi audit
# Check alert status
meshpi alerts status
# Push OTA update
meshpi ota push --image ./image.img --devices rpi-001,rpi-002
Features:
- ๐ Audit Logging - All fleet operations logged to JSONL
- ๐ Prometheus Metrics - CPU, memory, temperature, device count
- ๐จ Alert Engine - 9 default rules (temperature, memory, offline, etc.)
- ๐ OTA Updates - Staged rollout with A/B partition rollback
- ๐ Grafana Dashboards - Pre-built visualization templates
Docker Monitoring Stack:
# Start with Prometheus + Grafana
docker compose --profile monitoring up
# Access endpoints
open http://localhost:7422/metrics # Prometheus metrics
open http://localhost:9090 # Prometheus UI
open http://localhost:3000 # Grafana (admin/meshpi)
๐พ USB Offline Workflow
For air-gapped environments:
meshpi pendrive seed # Client: write public key to USB
meshpi pendrive export # Host: encrypt config to USB
meshpi pendrive apply # Client: apply config from USB
๐ฆ Installation
# Core package
pip install meshpi
# With LLM agent support
pip install "meshpi[llm]"
# Development dependencies
pip install "meshpi[dev]"
# Everything
pip install "meshpi[all]"
Requirements: Python 3.9+, Linux (host), Raspberry Pi OS (client)
๐๏ธ Architecture
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๐ MESHPI INSTALLATION FLOW โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ HOST PC โ โ CLIENT RPi โ
โ โ โ โ
โ meshpi config โ โ meshpi scan โ
โ โ โ โ โ โ
โ ~/.meshpi/ โ โ mDNS discovery โ
โ config.env โ โ โ โ
โ โ โ RSA key exchangeโ
โ meshpi host โโโโโโโโโโโโโโโโโโโโโโโ โ โ
โ โ โ Encrypted config โ Apply settings โ
โ FastAPI API โโโโโโโโโโโโโโโโโโโโโโถโ โ โ
โ โ โ โ Reboot โ
โ WebSocket โ โ โ โ
โ โ โ โ Ready! โ
โ Dashboard โ โ โ
โ โ โ โ โ
โ mDNS Adv โ โ โ
โโโโโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโโโโ
โ Persistent Connection
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ MESHPI DAEMON โ
โ โ
โ โข Diagnostics push (60s interval) โ
โ โข Real-time commands โ
โ โข Status updates โ
โ โข Health monitoring โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ ๏ธ CLI Reference
| Command | Description |
|---|---|
meshpi config |
Interactive configuration wizard |
meshpi host |
Start host service (FastAPI + mDNS) |
meshpi scan |
Discover hosts, download config |
meshpi daemon |
Persistent WebSocket connection |
meshpi diag |
Show device diagnostics |
meshpi hw list |
List hardware profiles |
meshpi hw apply <id> |
Apply hardware profile |
meshpi agent |
Launch LLM management agent |
meshpi info |
Show local keys/config state |
meshpi pendrive * |
USB offline workflow |
๐ง Environment Variables
MeshPi supports extensive configuration through environment variables. Copy .env.example to .env and customize.
๐ณ Docker & Deployment
# Host service
MESHPI_PORT=7422
MESHPI_BIND=0.0.0.0
# Client configuration
MESHPI_HOST_IP=localhost
MESHPI_HOST_PORT=7422
MESHPI_DEVICE_ID=meshpi-client
๐ง Configuration (MESHPI_CFG_*)
Environment variables with MESHPI_CFG_ prefix are automatically converted to config.env:
# WiFi
MESHPI_CFG_WIFI_SSID="MyNetwork"
MESHPI_CFG_WIFI_PASSWORD="MyPassword"
MESHPI_CFG_WIFI_COUNTRY="PL"
# SSH
MESHPI_CFG_RPI_USER="pi"
MESHPI_CFG_RPI_PASSWORD="raspberry"
MESHPI_CFG_SSH_ENABLE="yes"
# System
MESHPI_CFG_RPI_HOSTNAME="meshpi-node"
MESHPI_CFG_RPI_TIMEZONE="Europe/Warsaw"
๐ค LLM Agent
# LiteLLM configuration
LITELLM_MODEL=gpt-4o-mini
LITELLM_API_KEY=sk-...
LITELLM_API_BASE=https://api.openai.com/v1
# Alternative providers
OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
๐ Complete Reference
See .env.example for all available variables including:
- Docker & Deployment: Port, binding, client settings
- Configuration: SSH, WiFi, hostname, hardware interfaces
- LLM Agent: Multiple provider support
- Testing: Test devices, SSH keys, timeouts
- Security: Key paths, crypto settings
- Monitoring: Log levels, file paths
๐ Standard Documentation
For standardized documentation on device groups and hardware profiles, see:
- Complete Deployment Guide - Comprehensive step-by-step deployment guide
- Cheat Sheet - Quick reference commands and scenarios
- Standard Documentation - Complete guide to groups (devices) and profiles (OS/drivers)
- Standards Table - Quick reference table of all standards
- Hardware Group Management - Advanced group operations
- SSH Hardware Management - Remote hardware control
๐ Repository Organization
meshpi/
โโโ test/ # Test scripts and utilities
โ โโโ batch-rpi-test.sh # Batch testing for multiple RPis
โ โโโ test-doctor.sh # Doctor functionality tests
โ โโโ test-enhanced-cli.sh # CLI feature tests
โ โโโ test-list.sh # List functionality tests
โ โโโ test-restart.sh # Restart functionality tests
โ โโโ test-ssh-host.sh # SSH host tests
โ โโโ test-ssh-scan-identify.sh # SSH scan tests
โ โโโ run-rpi-tests.sh # Main Docker test runner
โโโ scripts/ # Tooling and utility scripts
โ โโโ diagnose-rpi.sh # Comprehensive RPi diagnostics
โ โโโ fix-rpi-meshpi.sh # Automated common issue fixes
โ โโโ monitor-repair.py # Real-time repair status monitor (Python)
โ โโโ project.py # Code analysis tool (Python)
โ โโโ remote-rpi-test.sh # Remote RPi testing via SSH
โ โโโ rpi-service-manager.sh # Service management
โ โโโ show-repair-status.py # Visual repair status display (Python)
โโโ meshpi/ # Core Python package
โโโ docker/ # Docker configurations
โโโ docs/ # Documentation
โโโ tests/ # Unit tests
๐งช Development
# Clone and setup
git clone https://github.com/pyfunc/meshpi.git
cd meshpi
make venv
make dev
# Run tests
make test
# Build package
make build
# Publish to PyPI
make publish
๐ณ Docker
# Build image
docker build -t meshpi .
# Run host
docker run -p 7422:7422 meshpi
# Docker Compose
docker-compose up -d meshpi-host
๐ License
Apache License 2.0 - see LICENSE for details.
๐ค Author
Tom Sapletta
๐ง tom@sapletta.com
๐ข Softreck - Embedded systems, IoT automation
๐ Links
- ๐ฆ PyPI: pypi.org/project/meshpi
- ๐ป GitHub: github.com/pyfunc/meshpi
- ๐ Documentation: github.com/pyfunc/meshpi#readme
- ๐ Issues: github.com/pyfunc/meshpi/issues
- ๐ Sponsor: github.com/sponsors/pyfunc
Made with โค๏ธ for the Raspberry Pi community
License
Apache License 2.0 - see LICENSE for details.
Author
Created by Tom Sapletta - tom@sapletta.com
Metadata
Release files for meshpi 0.1.35
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| meshpi-0.1.35.tar.gz | 137.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| meshpi-0.1.35-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 260.1 kB
Release files / meshpi-0.1.35.tar.gz
| Download URL | meshpi-0.1.35.tar.gz |
|---|---|
| Size | 137.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
424048bc30f86408d3ebe92e0ae92b8a10470b017eca46fc05d2df1aeb7885c9
|
|
BLAKE2b-256 checksum How to use checksums |
ebc571e72a8d99323baa383fd7ea8f50a4740a063abe6e53d6accb4e9dc7c777
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|
Release files / meshpi-0.1.35-py3-none-any.whl
| Download URL | meshpi-0.1.35-py3-none-any.whl |
|---|---|
| Size | 122.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
172b0762f9e2438192220ab3d5cdaed6e3e93bcce17500a1387a38ab48eb870c
|
|
BLAKE2b-256 checksum How to use checksums |
77e7ee61f81611c376d62f3f1a26e7dfb6f72d69824358b34fc13c5aec305951
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.7
|