🎥 Real-Time Object Detection & Tracking System

This project provides a modular, scalable system for real-time video stream processing, including object detection (via YOLO), object tracking, result storage, API access, and visual analytics.

---

🚀 Features

• Connects to IP/RTSP/USB camera streams
• Runs real-time object detection using YOLOv8
• Tracks objects across frames with unique IDs
• Stores detection/tracking data to a database or file system
• Exposes REST API via FastAPI
• Web UI for monitoring and analytics
• Configurable via environment or settings file
• Modular structure for clean testing and extension

---

🗂️ Project Structure

.
├── api/                    # FastAPI application and endpoints
├── core/                   # Abstract business logic (e.g., detection interfaces)
├── infrastructure/         # Implementations: camera, storage, models, messaging
├── analytics/              # Post-processing and reporting tools
├── models/                 # YOLO and tracking model configs
├── ui/                     # Web and admin UIs
├── scripts/                # Maintenance, deployment, and migration scripts
├── tests/                  # Unit, integration, and e2e tests
├── docs/                   # Documentation and architecture diagrams
└── README.md               # Project entry point (this file)