mediapipe/docs/getting_started/python.md
MediaPipe Team 4dc4b19ddb Project import generated by Copybara.
GitOrigin-RevId: 1e13be30e2c6838d4a2ff768a39c414bc80534bb
2022-09-06 21:46:17 +00:00

4.5 KiB

layout title parent has_children has_toc nav_order
default MediaPipe in Python Getting Started true false 3

MediaPipe in Python

{: .no_toc }

  1. TOC {:toc}

Ready-to-use Python Solutions

MediaPipe offers ready-to-use yet customizable Python solutions as a prebuilt Python package. MediaPipe Python package is available on PyPI for Linux, macOS and Windows.

You can, for instance, activate a Python virtual environment:

$ python3 -m venv mp_env && source mp_env/bin/activate

Install MediaPipe Python package and start Python interpreter:

(mp_env)$ pip install mediapipe
(mp_env)$ python3

In Python interpreter, import the package and start using one of the solutions:

import mediapipe as mp
mp_face_mesh = mp.solutions.face_mesh

Tip: Use command deactivate to later exit the Python virtual environment.

To learn more about configuration options and usage examples, please find details in each solution via the links below:

MediaPipe on Google Colab

MediaPipe Python Framework

The ready-to-use solutions are built upon the MediaPipe Python framework, which can be used by advanced users to run their own MediaPipe graphs in Python. Please see here for more info.

Building MediaPipe Python Package

Follow the steps below only if you have local changes and need to build the Python package from source. Otherwise, we strongly encourage our users to simply run pip install mediapipe to use the ready-to-use solutions, more convenient and much faster.

MediaPipe PyPI currently doesn't provide aarch64 Python wheel files. For building and using MediaPipe Python on aarch64 Linux systems such as Nvidia Jetson and Raspberry Pi, please read here.

  1. Make sure that Bazel and OpenCV are correctly installed and configured for MediaPipe. Please see Installation for how to setup Bazel and OpenCV for MediaPipe on Linux and macOS.

  2. Install the following dependencies.

    Debian or Ubuntu:

    $ sudo apt install python3-dev
    $ sudo apt install python3-venv
    $ sudo apt install -y protobuf-compiler
    
    # If you need to build opencv from source.
    $ sudo apt install cmake
    

    macOS:

    $ brew install protobuf
    
    # If you need to build opencv from source.
    $ brew install cmake
    

    Windows:

    Download the latest protoc win64 zip from the Protobuf GitHub repo, unzip the file, and copy the protoc.exe executable to a preferred location. Please ensure that location is added into the Path environment variable.

  3. Activate a Python virtual environment.

    $ python3 -m venv mp_env && source mp_env/bin/activate
    
  4. In the virtual environment, go to the MediaPipe repo directory.

  5. Install the required Python packages.

    (mp_env)mediapipe$ pip3 install -r requirements.txt
    
  6. Build and install MediaPipe package.

    (mp_env)mediapipe$ python3 setup.py install --link-opencv
    

    or

    (mp_env)mediapipe$ python3 setup.py bdist_wheel