layout: forward target: title: MediaPipe in Python parent: Getting Started has_children: true has_toc: false nav_order: 3

MediaPipe in Python

{: .no_toc }

  1. TOC {:toc}

Attention: Thanks for your interest in MediaPipe! We have moved to as the primary developer documentation site for MediaPipe as of April 3, 2023.

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 =

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 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


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


    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 install --link-opencv


    (mp_env)mediapipe$ python3 bdist_wheel
  7. Exit from the MediaPipe repo directory and launch the Python interpreter.