How shakhboz06/ai-powered-video-analytics-security-pipeline works
This is a prototype video-security analytics pipeline. Camera frames or uploaded clips are ingested, analyzed by Python inference workers, and passed to a Go aggregator for alert rules and persistence; the Go API and Nuxt dashboard expose detections, alerts, zones, live views, and upload results. Evidence-frame handling and notification are additional product branches. Dashed edges mark relationships documented only at a high level; unsampled source is not treated as verified.
Main entry points: dashboard/main.go Dashboard API · aggregator/main.go Alert aggregator · useApi.ts Frontend API client · storage.go Redis cache
Components 18
Video ingestion
- Upload ingestor
ingestor/upload_ingestor.py - Camera ingestor
ingestor/ingestor.py
AI inference
- Inference worker
worker/worker.py - Worker variant
worker-1.py
Alert processing
- Alert aggregator
aggregator/main.go - Behavior detectors
aggregator - Alert notifier
notifier/main.go
API and storage
- Upload endpoint
dashboard/cmd/api/upload.go - TimescaleDB
db/postgres/db.go - Redis cache
db/redis/cache/storage.go - Dashboard API
dashboard/main.go - Detection store
dashboard/internal/store/detections.go
Dashboard experience
- Frontend API client
nuxt-dashboard/app/composables/useApi.ts - Security dashboard
nuxt-dashboard/app/pages/alerts.vue
Other components
- Camera feed
- Operator / browser
- Kafka topics
- Private evidence storage
Connections 22
- Camera feed → Camera ingestor: provides frames
ingestor/ingestor.py - Camera ingestor → Kafka topics: publishes frames
ingestor/ingestor.py - Operator / browser → Upload endpoint: submits clip
- Upload endpoint → Upload ingestor: queues job
- Upload ingestor → Kafka topics: publishes frames
ingestor/upload_ingestor.py - Kafka topics → Inference worker: dispatches frames
- Kafka topics → Worker variant: dispatches frames
- Inference worker → Kafka topics: publishes results
- Worker variant → Private evidence storage: stores evidence
worker-1.py - Kafka topics → Alert aggregator: delivers detections
- Alert aggregator → Behavior detectors: applies rules
- Alert aggregator → TimescaleDB: writes alerts and detections
aggregator/main.go - Alert aggregator → Redis cache: publishes notifications
- Redis cache → Alert notifier: notifies subscribers
- Operator / browser → Frontend API client: uses dashboard
- Frontend API client → Dashboard API: requests API data
nuxt-dashboard/app/composables/useApi.ts - Dashboard API → Detection store: routes detection queries
dashboard/main.go - Detection store → TimescaleDB: reads detections
- Dashboard API → Redis cache: serves live streams
dashboard/main.go - Dashboard API → Frontend API client: returns API results
- Frontend API client → Security dashboard: feeds dashboard views
- Private evidence storage → Dashboard API: serves signed URLs