https://github.com/cansik/mediapipe-extended
Mediapipe for python with extended solution support.
https://github.com/cansik/mediapipe-extended
Last synced: about 1 month ago
JSON representation
Mediapipe for python with extended solution support.
- Host: GitHub
- URL: https://github.com/cansik/mediapipe-extended
- Owner: cansik
- License: apache-2.0
- Created: 2023-02-23T12:47:29.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-04-26T10:19:47.000Z (about 2 years ago)
- Last Synced: 2025-03-31T02:12:21.535Z (3 months ago)
- Language: PowerShell
- Homepage:
- Size: 5.7 MB
- Stars: 16
- Watchers: 2
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Mediapipe-Extended [](https://github.com/cansik/mediapipe-extended/actions/workflows/build.yml)
Mediapipe for Python with extended solution support. The aim of this repository is to add [solutions](https://google.github.io/mediapipe/solutions/solutions.html) to mediapipe that are not included in the original mediapipe Python package. This repository just provides the build script and examples for mediapipe-extended. The build script uses the [face-geometry-python](https://github.com/cansik/mediapipe/tree/face-geometry-python) branch to build the python wheel package.
### Installation
Until a PyPi package is released, use pip to install the wheel directly.
```
pip install -r requirements.txt
pip install https://github.com/cansik/mediapipe-extended/releases/download/v0.9.1/mediapipe_extended-0.9.1-cp39-cp39-macosx_12_0_arm64.whl
```
[Prebuilt](https://github.com/cansik/mediapipe-extended/releases/tag/v0.9.1) wheels for the following python versions and operating systems are available.
- Python (`3.8`, `3.9`, `3.10`, `3.11`)
- Windows amd64, Linux x86-x64, MacOS x64 (Intel), MacOS arm64 (M1/M2)
### Face Geometry
The Face Geometry solution allows the head transformation matrix to be recovered from the landmark detection. This enables face effects or undistorted landmark analysis.
#### Augmented Reality
Project filters onto the face by using the geometry information.
```bash
python examples/FaceGeometryExample.py
```
#### Measure Distance
Measure distances between landmarks without the perspective distortion.
```bash
python examples/NeutralFaceLandmarkExample.py
```
### Build
To create a wheel package, set up your computer as described in [Mediapipe: Getting Started](https://google.github.io/mediapipe/getting_started/python.html#mediapipe-python-framework) and run the following command (Powershell Core is required). Please use a more recent version of powershell (e.g. `PowerShell 7.3.2`) and install the following dependency managers for your system:
- Windows -> [Chocolately](https://chocolatey.org/)
- Linux -> apt
- MacOS -> [Homebrew](https://brew.sh/)
```bash
pwsh tools/build.ps1
```
### About
Apache-2.0 license - Copyright (c) 2023 Florian Bruggisser