mediapipe-rs/README.md
Jules Youngberg 559a9deb88 update readme
2022-07-26 17:50:24 -07:00

2.0 KiB

mediapipe-rs

Simple rust bindings for mediapipe.

Forked from: https://github.com/angular-rust/ux-mediapipe 🙏

And heavily based on this example: https://github.com/asprecic/mediapipe-qt-integration-example 🤌

requirements

setup

To run the examples clone this project.

git clone https://github.com/julesyoungberg/mediapipe-rs.git

Mediapipe is a framework for building AI-powered computer vision applications. It provides high level libraries exposing some of its solutions for common problems. This package makes some of these solutions available in Rust. In order to use it we must build a custom mediapipe C++ library.

Clone the modified Mediapipe repo next to mediapipe-rs or a project that uses mediapipe-rs.

git clone https://github.com/julesyoungberg/mediapipe.git
cd mediapipe

building mediapipe

Build & install the mediagraph library.

mac os

bazel build --define MEDIAPIPE_DISABLE_GPU=1 mediapipe:libmediagraph.dylib
sudo cp bazel-bin/mediapipe/libmediagraph.dylib /usr/local/lib/libmediagraph.dylib

linux (untested)

bazel build --define MEDIAPIPE_DISABLE_GPU=1 mediapipe:mediagraph
cp bazel-bin/mediapipe/libmediagraph.so /usr/local/lib/libmediagraph.so

linking

Navigate to the project directory and create a symbolic link to ../mediapipe/mediapipe.

cd ../mediapipe-rs # or the path to your project
ln -s ../mediapipe/mediapipe .

usage

Add the following to your dependencies list in Cargo.toml:

mediapipe = { git = "https://github.com/julesyoungberg/mediapipe-rs" }

Mediapipe relies on tflite files which must be available at ./mediapipe/modules/. The easiest way to satisfy this is by creating a symbolic link to mediapipe as explained in the linking section above.

examples

Examples are located in the ./examples directory. Run face_mesh.rs with

cargo run --release --example face_mesh