Metadata-Version: 2.4
Name: pymtcnn
Version: 1.1.3
Summary: High-performance cross-platform MTCNN face detection with CUDA and Apple Neural Engine support
Home-page: https://github.com/johnwilsoniv/pymtcnn
Author: SplitFace
License: CC BY-NC 4.0
Project-URL: Homepage, https://github.com/johnwilsoniv/pymtcnn
Project-URL: Documentation, https://github.com/johnwilsoniv/pymtcnn/blob/main/README.md
Project-URL: Repository, https://github.com/johnwilsoniv/pymtcnn
Project-URL: Bug Tracker, https://github.com/johnwilsoniv/pymtcnn/issues
Keywords: face detection,mtcnn,coreml,apple neural engine,computer vision,deep learning
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: License :: Other/Proprietary License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: MacOS
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numpy>=1.20.0
Requires-Dist: opencv-python>=4.5.0
Provides-Extra: coreml
Requires-Dist: coremltools>=7.0; extra == "coreml"
Provides-Extra: onnx
Requires-Dist: onnxruntime>=1.16.0; extra == "onnx"
Provides-Extra: onnx-gpu
Requires-Dist: onnxruntime-gpu>=1.16.0; extra == "onnx-gpu"
Provides-Extra: all
Requires-Dist: coremltools>=7.0; extra == "all"
Requires-Dist: onnxruntime-gpu>=1.16.0; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pillow>=9.0.0; extra == "dev"
Requires-Dist: matplotlib>=3.5.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# pymtcnn

MTCNN face detection with CoreML (Apple Silicon) and CUDA support.

## Installation

```bash
pip install pymtcnn
```

## Usage

```python
from pymtcnn import MTCNN

detector = MTCNN()  # auto-selects best backend
boxes, landmarks = detector.detect(image)
```

## What it does

- Detects faces and 5-point facial landmarks
- Auto-selects backend: CoreML on Mac, CUDA on NVIDIA, CPU fallback
- ~34 FPS on Apple Silicon, ~50 FPS on CUDA

## Citation

If you use this in research, please cite:

> Wilson IV, J., Rosenberg, J., Gray, M. L., & Razavi, C. R. (2025). A split-face computer vision/machine learning assessment of facial paralysis using facial action units. *Facial Plastic Surgery & Aesthetic Medicine*. https://doi.org/10.1177/26893614251394382

## License

CC BY-NC 4.0 — free for non-commercial use with attribution.
