LightWise is a fault-tolerant telemetry platform designed to manage distributed, sensor-rich lighting infrastructure at scale. By bridging the gap between autonomous embedded firmware and cloud-based analytics, LightWise enables municipalities to transform standard streetlights into intelligent, self-healing edge nodes.
Traditional streetlight management is reactive and costly. Municipalities have no visibility into infrastructure health until a bulb burns out, a sensor fails, or a citizen complains. When problems occur, technicians must physically drive to each location to diagnose and repair.
LightWise eliminates truck rolls through:
-
Remote Diagnostics: Real-time telemetry streams from every streetlight, enabling operations teams to diagnose issues from the office
-
Autonomous Health Monitoring: Embedded fault detection automatically identifies failures and enters graceful degraded modes
-
Visibility-Driven Decisions: Dashboard insights mean technicians are dispatched only when remote diagnostics confirm actual hardware issues
Impact: 30–50% reduction in maintenance costs, faster response to critical failures, and better asset utilization across thousands of streetlights.
- Autonomous Operation: Local decision-making allows each streetlight to function independently
- Fault Tolerance: Automatic degradation modes maintain core functionality during partial sensor failure
- Health Self-Assessment: Device-side validation ensures data quality before transmission
- LoRaWAN Integration: Long-range, low-power communication optimized for dense urban coverage
- Hybrid Telemetry: Event-driven alerts for critical issues + periodic heartbeats for health monitoring
- Graceful Degradation: System remains operational even during cloud connectivity loss
- Real-time Dashboard: Unified view of entire fleet health with drill-down capabilities
- Predictive Analytics: Historical trend analysis supports proactive maintenance scheduling
This README provides a high-level overview only.
Detailed technical and planning documentation is maintained in the /docs directory:
- System Architecture: Overall platform design and data flow
- Database Schema: Data models, access patterns, and retention strategy
- API Contracts: Telemetry ingestion and service interfaces
- Firmware Architecture: ESP32 and component flow
- Hardware Specifications: Hardware component specification
- Sprint Plans & Backlog: Project planning and progress tracking
- Contributing: Development standards
- License: Project licensing terms
Please refer to the appropriate document for details.
LightWise/
├── .github/
│ └── workflows/ # CI/CD pipelines (firmware, frontend, lambda)
│
├── apps/
│ ├── api/ # Serverless backend (AWS Lambda functions)
│ └── web/ # Web dashboard (React frontend)
│
├── docs/ # System-level documentation
├── firmware/ # Embedded firmware (device drivers, RTOS)
├── scripts/ # Build, deployment, and automation scripts
│
├── .gitignore
├── LICENSE
├─- README.md # Main project documentation
└── CONTRIBUTING.md # Contributing guideline
This repository contains three main components:
- Web UI — React frontend
- Backend API — AWS Lambda (Python)
- Firmware — PlatformIO embedded firmware
Follow the section for the component you want to run.
- Git
- Node.js 16+ (for frontend)
- Python 3.8+ (for backend)
- PlatformIO CLI (for firmware; or use VSCode extension)
cd firmware
pio run
pio run -t upload # Flash firmware to device
pio device monitor # Monitor logs- Install Dependencies
cd apps/web
npm install- Start Development Server
npm start- Production Build
npm run build- Create Virtual Environment
# Linux / MacOS
python3 -m venv .venv
source .venv/bin/activate
# Windows
python -m venv .venv
.venv\Scripts\activate- Install dependencies
pip install -r requirements.txtVersion: 1.5
Last Updated: Aug 8, 2026