README.md

---
title: TrackIQ — Traffic Road Detection
emoji: 🚦
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
app_port: 7860
---

# 🚦 TrackIQ — Traffic Road Detection App

TrackIQ is a real-time traffic object detection and tracking application powered by YOLO.

## Features

- 🎥 Upload and analyze traffic videos
- 🚗 Detect vehicles, motorcycles, trucks, buses, pedestrians, bicycles, traffic lights, and road signs
- 📊 Live dashboard with detection statistics
- 📁 Session history and CSV log export
- ⚡ CPU-optimized inference with frame skipping

## How to Use

1. Go to the **Home** page and upload a video
2. Click **Run** to start detection
3. Watch detections stream live on the video
4. View stats on the **Dashboard**
5. Export logs from the **Logs** page

## Model

> ⚠️ **Upload your YOLO model** to the `models/` folder before running.
> Supported: `yolo11n.pt`, `yolov8n.pt`, etc.

Upload the model via the **Files** tab in your HuggingFace Space settings.

## Tech Stack

- Flask (Python backend)
- Ultralytics YOLO
- OpenCV
- HTML/CSS/JS frontend