person-detector 0.0.3

A high level API for detecting and tracking people.

Person Detector

Highly performant, and accurate, real-time person tracking with YOLOv10 and ByteTrack

Command-Line Interface

Clone repo and navigate to project directory

git clone [e-mail]:k3y5tr0k3/person-detector.git && cd person-detector

Install requirements

pip install -r requirements.txt

Example usage

Detections from Image

python -m src.main --image 'path/to/image.jpg' --detection --show

Detections from Video

python -m src.main --video 'path/to/video.mp4' --detection --show

Trajectory Tracking from Video

python -m src.main -video 'path/to/video.mp4' --tracking --show

For more info, use the help flag

python -m src.main --help

Utility Functions

Convert video to images

python -m src.main --video2images 'path/to/video.mp4

Generate Developer Documentation (Optional)

pdoc ./src

Using as package in your project

Install with PIP

pip install py-person-detector

Example Usage

Detecting people in an image

import pathlib
from person_detector.detector import Detector

detector = Detector(show=True)

image_path = pathlib.Path("path/to/image.jpg")
detector.detect_image(image_path)