people_counter/README.md
2025-08-02 04:26:14 +02:00

21 lines
897 B
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# People Counter with YOLOv8, ByteTrack, and Prometheus
This project implements a real-time people counting system based on object detection and tracking using [YOLOv8](https://github.com/ultralytics/ultralytics) and [ByteTrack](https://github.com/ifzhang/ByteTrack). It supports **MJPEG input**, **in/out counting** using either a vertical or a horizontal line, and exposes **Prometheus metrics** for integration with monitoring systems.
## 🚀 Features
- 🎥 MJPEG camera stream input
- 🧠 YOLOv8 person detection
- 🔁 ByteTrack object tracking
- In/Out counting via virtual line
- 📊 Prometheus metrics at `http://localhost:9100/`
- 🌐 Web UI for live video and statistics
## Start MJPEG stream from webcam
mjpg_streamer -i "input_uvc.so -d /dev/video0 -r 1280x720 -f 30" -o "output_http.so -p 8080"
## Run application
```
uvicorn main:app --host 0.0.0.0 --port 8000
```