🔷 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

⬆ Back to Top

Made with ❤️ for the Raspberry Pi community

License

Apache License 2.0 - see LICENSE for details.

Author

Created by Tom Sapletta - tom@sapletta.com

Name		Name	Last commit message	Last commit date
Latest commit History 41 Commits
.github/workflows		.github/workflows
client		client
deploy		deploy
docker/test-rpi		docker/test-rpi
docs		docs
examples		examples
meshpi		meshpi
scripts		scripts
test-env		test-env
test		test
tests		tests
.env.example		.env.example
.gitignore		.gitignore
<MagicMock name='_config_txt_path()' id='140086943225840'>		<MagicMock name='_config_txt_path()' id='140086943225840'>
<MagicMock name='_config_txt_path()' id='140086943227184'>		<MagicMock name='_config_txt_path()' id='140086943227184'>
<MagicMock name='_config_txt_path()' id='140086943227856'>		<MagicMock name='_config_txt_path()' id='140086943227856'>
<MagicMock name='_config_txt_path()' id='140086943228192'>		<MagicMock name='_config_txt_path()' id='140086943228192'>
<MagicMock name='_config_txt_path()' id='140086943231552'>		<MagicMock name='_config_txt_path()' id='140086943231552'>
<MagicMock name='_config_txt_path()' id='140086943233232'>		<MagicMock name='_config_txt_path()' id='140086943233232'>
<MagicMock name='_config_txt_path()' id='140086945398864'>		<MagicMock name='_config_txt_path()' id='140086945398864'>
<MagicMock name='_config_txt_path()' id='140086945399200'>		<MagicMock name='_config_txt_path()' id='140086945399200'>
<MagicMock name='_config_txt_path()' id='140086945402224'>		<MagicMock name='_config_txt_path()' id='140086945402224'>
<MagicMock name='_config_txt_path()' id='140086957155264'>		<MagicMock name='_config_txt_path()' id='140086957155264'>
<MagicMock name='_config_txt_path()' id='140086957159968'>		<MagicMock name='_config_txt_path()' id='140086957159968'>
=5.9		=5.9
CHANGELOG.md		CHANGELOG.md
CONTRIBUTING.md		CONTRIBUTING.md
Dockerfile		Dockerfile
Dockerfile.client		Dockerfile.client
ENHANCED-CLI-FEATURES.md		ENHANCED-CLI-FEATURES.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
RPI-TESTING-README.md		RPI-TESTING-README.md
TICKET		TICKET
TODO.md		TODO.md
VERSION		VERSION
ci.yml		ci.yml
docker-compose.test-rpi.yml		docker-compose.test-rpi.yml
docker-compose.yml		docker-compose.yml
entrypoint.sh		entrypoint.sh
fake_applier.py		fake_applier.py
goal.yaml		goal.yaml
project.functions.toon		project.functions.toon
project.sh		project.sh
project.toon-schema.json		project.toon-schema.json
pyproject.toml		pyproject.toml

License

pyfunc/meshpi

Folders and files

Latest commit

History

Repository files navigation

🔷 MeshPi

Zero-Touch Raspberry Pi Fleet Management

🏗️ Architektura Systemu

📋 Overview

⚡ Quick Start

📱 Client Setup (Raspberry Pi)

🔧 Prerequisites Setup

1. Connect to Internet

2. Update System

3. Install Python pip

4. Install MeshPi

5. Run MeshPi Scan

🚀 One-Liner Installation

📋 What Happens During Scan

🛠️ Troubleshooting

✨ Features

🔐 Encrypted Zero-Touch Provisioning

📡 Real-Time Fleet Management

🔧 49+ Hardware Profiles with Group Management

🤖 LLM-Powered Agent

📊 Full Diagnostics

📈 Monitoring & Observability

💾 USB Offline Workflow

📦 Installation

🏗️ Architecture

🛠️ CLI Reference

🔧 Environment Variables

🐳 Docker & Deployment

🔧 Configuration (MESHPI_CFG_*)

🤖 LLM Agent

📋 Complete Reference

📚 Standard Documentation

📁 Repository Organization

🧪 Development

🐳 Docker

📄 License

👤 Author

🔗 Links

License

Author

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages