---
sdk: gradio
title: Edge Node Diagnostics Agent
emoji: 🔬
colorFrom: blue
colorTo: purple
sdk_version: 6.14.0
python_version: '3.13'
app_file: app.py
pinned: false
tags:
- ml-intern
- diagnostics
- edge-computing
- face-recognition
---

# 🔬 Edge Node Diagnostics Agent

A specialized AI assistant for troubleshooting and optimizing the SmartClass face recognition pipeline running on classroom edge devices (Raspberry Pi 5 / Intel NUC).

## Features

### 💬 Conversational Diagnostics
Ask natural language questions about your edge node's health and get detailed, actionable diagnosis with specific configuration changes.

### 🔧 Diagnostic Tools
The agent automatically queries relevant subsystems:
- **Pipeline Status** — Overall health and component status
- **Prometheus Metrics** — Real-time performance data
- **Detection Analysis** — SCRFD model performance
- **Recognition Analysis** — MobileFaceNet + FAISS status
- **Tracking Analysis** — ByteTrack subsystem
- **Event Transmission** — Redis/HTTP/SQLite delivery
- **Identity Engine** — Evidence accumulation status
- **Error Logs** — Recent warnings and errors
- **Configuration** — Current YAML settings

### 📊 Live Metrics Dashboard
Real-time (simulated) Prometheus metrics visualization updating every 5 seconds.

### ⚙️ Configuration Panel
Interactive sliders for tuning all pipeline parameters with immediate effect.

### 💥 Fault Injection
Simulate common failure scenarios to test diagnostic capabilities:
- Low FPS (heavy processing load)
- Redis Disconnect (network failure)
- No Recognitions (threshold misconfiguration)
- High Temperature (thermal throttling)
- Tracking Chaos (ghost tracks)

## Pipeline Architecture

```
Camera → SCRFD Detection → ByteTrack → Quality Gate → Face Align → MobileFaceNet → FAISS Search → Identity Evidence Engine → Redis/HTTP/SQLite
```

## Example Questions

- "The edge node is only getting 2 FPS, how do I optimize?"
- "Faces are detected but never recognized"
- "Tracking IDs keep switching between the same person"
- "The offline queue keeps growing, events aren't being sent"
- "How do I tune the identity evidence engine?"

## Technical Stack

- **Detection:** SCRFD (ONNX Runtime)
- **Tracking:** ByteTrack
- **Recognition:** MobileFaceNet / AdaFace ensemble
- **Search:** FAISS (cosine similarity)
- **Transmission:** Redis Streams → HTTP fallback → SQLite offline queue
- **Monitoring:** Prometheus metrics on port 9100