Metadata-Version: 2.4
Name: deep-person
Version: 0.2.0
Summary: Person re-identification component for Vbot framework
Project-URL: Homepage, https://github.com/VitaDynamics/DeepPerson
Project-URL: Repository, https://github.com/VitaDynamics/DeepPerson
Project-URL: Issues, https://github.com/VitaDynamics/DeepPerson/issues
Project-URL: Documentation, https://github.com/VitaDynamics/DeepPerson#readme
Author-email: VitaDynamics <info@vitadynamics.org>
License: MIT
License-File: LICENSE
Keywords: computer-vision,deep-learning,person-reid,resnet,yolo
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: deepface>=0.0.95
Requires-Dist: gdown>=5.0.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pillow>=9.0.0
Requires-Dist: scikit-learn>=1.2.0
Requires-Dist: tf-keras>=2.18.0
Requires-Dist: torch>=2.0.0
Requires-Dist: torchvision>=0.15.0
Requires-Dist: tqdm>=4.64.0
Requires-Dist: ultralytics>=8.3.224
Provides-Extra: all
Requires-Dist: mypy>=1.0.0; extra == 'all'
Requires-Dist: pytest-cov>=4.0.0; extra == 'all'
Requires-Dist: pytest>=7.0.0; extra == 'all'
Requires-Dist: ruff>=0.8.0; extra == 'all'
Requires-Dist: ultralytics>=8.3.224; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.8.0; extra == 'dev'
Description-Content-Type: text/markdown

# DeepPerson

[![PyPI version](https://badge.fury.io/py/deep-person.svg)](https://badge.fury.io/py/deep-person)
[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

A simple person re-identification system with automatic person detection and embedding generation.

## Installation

```bash
pip install deep-person
```

## Quick Start

```python
from deep_person import DeepPerson

dp = DeepPerson()

# Generate embeddings
result = dp.represent("person.jpg")

# Verify if two images show the same person
result = dp.verify("person1.jpg", "person2.jpg")
print(f"Same person: {result['verified']}")
```

## Features

- **Automatic person detection** - YOLO-based detection
- **Multi-modal embeddings** - Body (2048-dim) + Face (512-dim) or via Model Registry
- **Identity verification** - Cosine/Euclidean distance metrics
- **GPU acceleration** - Automatic CUDA detection with CPU fallback
- **Batch processing** - Efficient multi-image handling

## Requirements

- Python 3.11+
- Models downloaded automatically on first use
- Optional: CUDA GPU for faster processing
