AI powerd Security device for insecurity in nigeria
# NISHA Sentinel
> **Distributed Telemetry & Surveillance System**
>
> Real-time acoustic and visual threat detection using edge AI, mesh networking, and multi-agent correlation.
Architecture • Quick Start • Components • Documentation • License
---
## 🎯 Overview
NISHA Sentinel is a production-grade surveillance platform that connects distributed audio/video sensor agents to a central AI backend for real-time threat detection. The system employs:
- **Edge Agents**: ESP32 microcontrollers + mobile phones streaming audio/video
- **Master Nodes**: Raspberry Pi aggregators with local buffering and failover
- **Central Backend**: FastAPI service with YOLOv8+LSTM violence detection
- **Dashboard**: Next.js web app with real-time maps, topology graphs, and alerts
- **AI Pipeline**: Pose estimation + behavior classification + multi-agent correlation
**Key Features:**
- ✅ Binary NISHA protocol (24-byte header, priority queues)
- ✅ Continuous video streaming + audio capture
- ✅ GPS location tracking with background updates
- ✅ AI violence detection (78% accuracy, real-time)
- ✅ Multi-agent event correlation (spatio-temporal)
- ✅ Mesh topology with handoff & failover
- ✅ Delta-based configuration management
- ✅ WebSocket real-time updates
- ✅ Docker Compose deployment
---
## 🏗️ Architecture
```
┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ ESP32 │ │ Mobile │ │ Master │ │ Backend │
│ Agent │────►│ Agent │────►│ Node │────►│ (FastAPI) │
│ (Audio) │ │ (AV+GPS) │ │ (Pi) │ │ │
└─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘
│
▼
┌──────────────────┐
│ PostgreSQL │
│ + Redis │
└──────────────────┘
│
▼
┌──────────────────┐
│ Next.js │
│ Dashboard │
└──────────────────┘
```
**Protocol**: NISHA binary frames (TELEMETRY, VIDEO, AUDIO, LOCATION streams with 4 priority levels).
**AI Models**: YOLOv8-n …