How karimelbasiouni/traffilytics works
Traffilytics turns uploaded traffic video into vehicle detections, tracked trajectories, lane/zone assignments, traffic analytics and reports, exposed through an API and interactive dashboard. Its principal runtime path is job-driven: ingest frames and metadata, detect vehicles, track them, analyze trajectories, then persist results. Separate dataset and model-training/evaluation capabilities support the detector. The excerpts and SOURCE INDEX establish the main orchestration and module relationships; some route and dashboard details are unsampled, so those links are shown only where documented or indexed.
Main entry points: pipeline.py Pipeline worker · app.py HTTP API · videos.py Video routes · api.ts API client
Components 23
User interface
- Dashboard
frontend/src/pages/Overview.tsx - Job monitor
frontend/src/pages/Jobs.tsx - API client
frontend/src/api.ts
API and jobs
- HTTP API
backend/api/app.py - Video routes
backend/api/routes/videos.py - Analytics routes
backend/api/routes/analytics.py - Event routes
backend/api/routes/events.py - Job broker
backend/services/jobs.py - Pipeline worker
backend/services/pipeline.py
Video intelligence
- Video ingestion
computer_vision/preprocessing/video_processor.py - OBB detector
computer_vision/detection/detector.py - Vehicle tracker
computer_vision/tracking/tracker.py - Lane assignment
computer_vision/trajectories/lanes.py - Trajectory generation
computer_vision/trajectories/generator.py - Tracking overlays
computer_vision/tracking/overlay.py
Traffic analytics
- Analytics engine
analytics/engine.py - Flow, events, insights
analytics
Data and model lifecycle
- SQL database
backend/database/session.py - Result persistence
backend/database/persist.py - UAV-OBB adapter
adapters/uav_obb - OBB training
computer_vision/detection/trainer.py - Detector evaluation
computer_vision/detection/evaluator.py
Other components
- Video analyst
Connections 24
- Video analyst → Dashboard: uploads video
README.md - Dashboard → API client: requests data
frontend/src/pages/Overview.tsx - Job monitor → API client: checks jobs
frontend/src/pages/Jobs.tsx - API client → HTTP API: calls HTTP API
- HTTP API → Video routes: registers routes
backend/api/app.py - HTTP API → Analytics routes: registers routes
backend/api/app.py - HTTP API → Event routes: registers routes
backend/api/app.py - Video routes → Video ingestion: reads metadata
backend/api/routes/videos.py - Video routes → Job broker: queues processing
backend/api/routes/videos.py - Job broker → Pipeline worker: runs pipeline
backend/api/app.py - Pipeline worker → Video ingestion: extracts frames
backend/services/pipeline.py - Pipeline worker → OBB detector: detects vehicles
backend/services/pipeline.py - Pipeline worker → Vehicle tracker: tracks detections
backend/services/pipeline.py - Pipeline worker → Trajectory generation: generates tracks
backend/services/pipeline.py - Pipeline worker → Lane assignment: assigns lanes
backend/services/pipeline.py - Pipeline worker → Analytics engine: analyzes trajectories
backend/services/pipeline.py - Analytics engine → Flow, events, insights: computes metrics
analytics/engine.py - Pipeline worker → Result persistence: persists results
backend/services/pipeline.py - Result persistence → SQL database: writes records
backend/database/persist.py - Video routes → SQL database: reads video records
backend/api/routes/videos.py - Pipeline worker → Tracking overlays: renders overlays
backend/services/pipeline.py - UAV-OBB adapter → OBB training: provides dataset
- OBB training → OBB detector: produces weights
- Detector evaluation → OBB detector: evaluates model
computer_vision/detection/evaluator.py