meshpi 0.1.12

🚀 Zero-touch provisioning for Raspberry Pi fleets - Configure WiFi, SSH, users, hardware peripherals, and manage devices through encrypted mesh networking

🔷 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

---

📋 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

# 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.

---

✨ Features

🔐 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

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

# Apply multiple profiles in one command
meshpi hw apply oled_ssd1306_i2c sensor_bme280 gpio_stepper_arm69ak

🤖 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.

💾 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

HOST (PC / RPi)                    CLIENT (fresh RPi)
─────────────────                  ─────────────────────
meshpi config                      meshpi scan
  → ~/.meshpi/config.env             → mDNS discovery
meshpi host                          → RSA key exchange
  → FastAPI REST API             ←   → Encrypted config
  → WebSocket /ws/{id}           →   → Apply & reboot
  → mDNS advertisement
  → Dashboard /dashboard
                           ↕
                    meshpi daemon
                      → Diagnostics push (60s)
                      → Real-time commands

---

🛠️ 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

---

🧪 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
📧 [e-mail]
🏢 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

---

⬆ Back to Top

Made with ❤️ for the Raspberry Pi community

License

Apache License 2.0 - see LICENSE for details.

Author

Created by Tom Sapletta - [e-mail]