meshpi 0.1.15

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

---

📱 Client Setup (Raspberry Pi)

🔧 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:

1. 🔍 Discover Host - Uses mDNS to find MeshPi hosts on your network
2. 🔑 Key Exchange - Generates RSA key pair and exchanges with host
3. 🔐 Download Config - Receives encrypted configuration
4. ⚙️ Apply Settings - Configures WiFi, SSH, users, locale
5. 🔄 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

🔐 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]