Metadata-Version: 2.1
Name: face-detection-tflite
Version: 0.2.0
Summary: A Python port of Google MediaPipe Face Detection modules
Home-page: https://github.com/patlevin/face-detection-tflite
Author: Patrick Levin
Author-email: vertical-pink@protonmail.com
License: MIT
Project-URL: Bug Tracker, https://github.com/patlevin/face-detection-tflite/issues
Description: # Face Detection For Python
        
        This package implements parts of Google®'s [**MediaPipe**](https://mediapipe.dev/#!) models in pure Python (with a little help from Numpy and PIL) without `Protobuf` graphs and with minimal dependencies (just [**TF Lite**](https://www.tensorflow.org/lite/api_docs) and [**Pillow**](https://python-pillow.org/)).
        
        ## Models and Examples
        
        The package provides the following models:
        
        * Face Detection
        
        ![Face detection example](https://raw.githubusercontent.com/patlevin/face-detection-tflite/main/docs/group_photo.jpg)
        
        * Face Landmark Detection
        
        ![Face landmark example](https://raw.githubusercontent.com/patlevin/face-detection-tflite/main/docs/portrait_fl.jpg)
        
        * Iris Landmark Detection
        
        ![Iris landmark example](https://raw.githubusercontent.com/patlevin/face-detection-tflite/main/docs/eyes.jpg)
        
        * Iris recoloring example
        
        ![Iris recoloring example](https://raw.githubusercontent.com/patlevin/face-detection-tflite/main/docs/recolored.jpg)
        
        ## Motivation
        
        The package doesn't use the graph approach implemented by **MediaPipe** and
        is therefore not as flexible. It is, however, somewhat easier to use and
        understand and more accessible to recreational programming and experimenting
        with the pretrained ML models than the rather complex **MediaPipe** framework.
        
        Here's how face detection works and an image like shown above can be produced:
        
        ```python
        from fdlite import FaceDetection
        from fdlite.render import Colors, detections_to_render_data, render_to_image 
        from PIL import Image
        
        image = Image.open('group.jpg')
        detect_faces = FaceDetection()
        faces = detect_faces(image)
        if len(faces) == 0:
            print('no faces detected :(')
        else:
            render_data = detections_to_render_data(faces, bounds_color=Colors.GREEN)
            render_to_image(render_data, image).show()
        ```
        
        While this example isn't that much simpler than the **MediaPipe** equivalent,
        some models (e.g. iris detection) aren't available in the Python API.
        
        ## Installation
        
        The latest release version is available in [PyPI](https://pypi.org/project/face-detection-tflite/0.1.0/)
        and can be installed via:
        
        ```sh
        pip install -U face-detection-tflite
        ```
        
        The package can be also installed from source by navigating to the folder
        containing `setup.py` and running
        
        ```sh
        pip install .
        ```
        
        from a shell or command prompt.
        
Keywords: AI,face-detection,tensorflow,tflite,face-landmarks,iris-detection,face-mesh
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Scientific/Engineering :: Image Recognition
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
