How himadri2041/purplle works
Purplle converts CCTV video into visitor and zone events, then ingests those events into a FastAPI analytics service. The main documented path is detection/tracking and staff filtering → event log → ingestion and normalization → store analytics → API results and dashboard. The graph also preserves the documented analytics capabilities and the separate video-processing/ReID implementation. Some pipeline internals and analytics endpoints were not sampled, so their connections are shown only where the README or source index supports them.
Main entry points: intelligence.py Intelligence store · detect_track.py Detection and tracking · main.py FastAPI service · process_video.py Video processor
Components 19
Video analytics
- Detection and tracking
pipeline/detect_track.py - Visitor identity
reid_manager.py - Staff filtering
pipeline/uniform.py - Video processor
pipeline/process_video.py - Zone classifier
pipeline/event_emitter.py
Event processing
- Event schema
pipeline/event_schema.py - Event log
api/events.jsonl - Event ingestion
app/ingestion.py
Store intelligence
- Intelligence store
api/intelligence.py - Metrics
app/metrics.py - Conversion funnel
app/funnel.py - Zone heatmap
api/intelligence.py - Anomaly detection
app/anomalies.py - Feed health
app/health.py - Analytics compatibility
api/analytics.py
API experience
- FastAPI service
app/main.py - Web dashboard
dashboard/index.html
Other components
- CCTV video
- Store operator
Connections 21
- CCTV video → Detection and tracking: provides footage
README.md - Detection and tracking → Staff filtering: filters staff
pipeline/detect_track.py - Detection and tracking → Event log: writes events
README.md - Detection and tracking → Event schema: emits event records
- Video processor → Visitor identity: assigns identities
pipeline/process_video.py - Video processor → Zone classifier: imports classifier
pipeline/process_video.py - Video processor → Event log: emits events
- Event log → Event ingestion: loads file
- FastAPI service → Event ingestion: routes ingest
app/main.py - Event ingestion → Intelligence store: ingests batch
app/ingestion.py - Event schema → Intelligence store: normalizes events
api/intelligence.py - FastAPI service → Intelligence store: requests analytics
app/main.py - Metrics → Intelligence store: requests metrics
app/metrics.py - Conversion funnel → Intelligence store: supports funnel
README.md - Zone heatmap → Intelligence store: computes heatmap
README.md - Anomaly detection → Intelligence store: supports anomalies
README.md - Feed health → Intelligence store: supports health
README.md - Analytics compatibility → Intelligence store: uses analytics store
api/analytics.py - Store operator → FastAPI service: requests results
README.md - Store operator → Web dashboard: views dashboard
README.md - Web dashboard → FastAPI service: requests data