Metadata-Version: 2.4
Name: faceswitch
Version: 0.2.0
Summary: Simple multi-model face detection library
Author: FaceSwitch Contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/game-sys/FaceSwitch
Project-URL: Bug Tracker, https://github.com/game-sys/FaceSwitch/issues
Project-URL: Documentation, https://github.com/game-sys/FaceSwitch/blob/main/README.md
Keywords: face-detection,computer-vision,hog,dlib
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: dlib>=19.24
Provides-Extra: hog
Requires-Dist: dlib>=19.24; extra == "hog"
Requires-Dist: ultralytics>=8.0.0; extra == "hog"
Provides-Extra: examples
Requires-Dist: opencv-python>=4.8; extra == "examples"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# FaceSwitch

FaceSwitch is an installable Python library for face detection backends.

## Install

```bash
pip install -e .
```

Install the HOG backend dependency:

```bash
pip install -e '.[hog]'
```

## Minimal Usage

```python
import cv2
from faceswitch import HogDetector

image = cv2.imread("tests/Lenna_test_image.png")
detector = HogDetector()
faces = detector.detect(image)
print(f"Detected: {len(faces)}")
```

## Example Script

```bash
pip install -e '.[hog,examples]'
python examples/demo_hog.py tests/Lenna_test_image.png
```
