インストール

Debian と Ubuntu へのインストール

  1. Bazelisk をインストールします。

    公式の Bazel ドキュメントに沿って Bazelisk をインストールします。

  2. MediaPipe リポジトリをチェックアウトします。

    $ cd $HOME
$ git clone --depth 1 https://github.com/google/mediapipe.git

# Change directory into MediaPipe root directory
$ cd mediapipe

  3. OpenCV と FFmpeg をインストールします。

    オプション 1: パッケージ管理システムを使用して、プリコンパイル済みの OpenCV ライブラリをインストールします。FFmpeg は libopencv-video-dev 経由でインストールされます。

    OS OpenCV
    Debian 9（stretch） 2.4
    Debian 10（buster） 3.2
    Debian 11（bullseye） 4.5
    Ubuntu 16.04 LTS 2.4
    Ubuntu 18.04 LTS 3.2
    Ubuntu 20.04 LTS 4.2
    Ubuntu 20.04 LTS 4.2
    Ubuntu 21.04 4.5 
    $ sudo apt-get install -y \
    libopencv-core-dev \
    libopencv-highgui-dev \
    libopencv-calib3d-dev \
    libopencv-features2d-dev \
    libopencv-imgproc-dev \
    libopencv-video-dev

    注: Debian 11 / Ubuntu 21.04 で OpenCV 4.5 が libopencv-video-dev でインストールされている場合は、libopencv-contrib-dev もインストールする必要があります。

    $ sudo apt-get install -y libopencv-contrib-dev

    MediaPipe の opencv_linux.BUILD と WORKSPACE は OpenCV 2/3 用にすでに構成されており、どのアーキテクチャでも正しく動作します。

    # WORKSPACE
new_local_repository(
  name = "linux_opencv",
  build_file = "@//third_party:opencv_linux.BUILD",
  path = "/usr",
)

# opencv_linux.BUILD for OpenCV 2/3 installed from Debian package
cc_library(
  name = "opencv",
  linkopts = [
    "-l:libopencv_core.so",
    "-l:libopencv_calib3d.so",
    "-l:libopencv_features2d.so",
    "-l:libopencv_highgui.so",
    "-l:libopencv_imgcodecs.so",
    "-l:libopencv_imgproc.so",
    "-l:libopencv_video.so",
    "-l:libopencv_videoio.so",
  ],
)

    OpenCV 4 の場合は、現在のアーキテクチャを考慮して opencv_linux.BUILD を変更する必要があります。

    # WORKSPACE
new_local_repository(
  name = "linux_opencv",
  build_file = "@//third_party:opencv_linux.BUILD",
  path = "/usr",
)

# opencv_linux.BUILD for OpenCV 4 installed from Debian package
cc_library(
  name = "opencv",
  hdrs = glob([
    # Uncomment according to your multiarch value (gcc -print-multiarch):
    #  "include/aarch64-linux-gnu/opencv4/opencv2/cvconfig.h",
    #  "include/arm-linux-gnueabihf/opencv4/opencv2/cvconfig.h",
    #  "include/x86_64-linux-gnu/opencv4/opencv2/cvconfig.h",
    "include/opencv4/opencv2/**/*.h*",
  ]),
  includes = [
    # Uncomment according to your multiarch value (gcc -print-multiarch):
    #  "include/aarch64-linux-gnu/opencv4/",
    #  "include/arm-linux-gnueabihf/opencv4/",
    #  "include/x86_64-linux-gnu/opencv4/",
    "include/opencv4/",
  ],
  linkopts = [
    "-l:libopencv_core.so",
    "-l:libopencv_calib3d.so",
    "-l:libopencv_features2d.so",
    "-l:libopencv_highgui.so",
    "-l:libopencv_imgcodecs.so",
    "-l:libopencv_imgproc.so",
    "-l:libopencv_video.so",
    "-l:libopencv_videoio.so",
  ],
)

    オプション 2: setup_opencv.sh を実行して、ソースから OpenCV を自動的にビルドし、MediaPipe の OpenCV 構成を変更します。このオプションを選択すると、オプション 3 で定義されているすべての手順が自動的に実行されます。

    オプション 3 OpenCV のドキュメントに沿って、ソースコードから OpenCV を手動でビルドします。

    MediaPipe が独自の OpenCV ライブラリを指すように、WORKSPACE と opencv_linux.BUILD の変更が必要になる場合があります。OpenCV はデフォルトで推奨される /usr/local/ にインストールされているとします。

    OpenCV 2/3 の設定:

    # WORKSPACE
new_local_repository(
  name = "linux_opencv",
  build_file = "@//third_party:opencv_linux.BUILD",
  path = "/usr/local",
)

# opencv_linux.BUILD for OpenCV 2/3 installed to /usr/local
cc_library(
  name = "opencv",
  linkopts = [
    "-L/usr/local/lib",
    "-l:libopencv_core.so",
    "-l:libopencv_calib3d.so",
    "-l:libopencv_features2d.so",
    "-l:libopencv_highgui.so",
    "-l:libopencv_imgcodecs.so",
    "-l:libopencv_imgproc.so",
    "-l:libopencv_video.so",
    "-l:libopencv_videoio.so",
  ],
)

    OpenCV 4 のセットアップ:

    # WORKSPACE
new_local_repository(
  name = "linux_opencv",
  build_file = "@//third_party:opencv_linux.BUILD",
  path = "/usr/local",
)

# opencv_linux.BUILD for OpenCV 4 installed to /usr/local
cc_library(
  name = "opencv",
  hdrs = glob([
    "include/opencv4/opencv2/**/*.h*",
  ]),
  includes = [
    "include/opencv4/",
  ],
  linkopts = [
    "-L/usr/local/lib",
    "-l:libopencv_core.so",
    "-l:libopencv_calib3d.so",
    "-l:libopencv_features2d.so",
    "-l:libopencv_highgui.so",
    "-l:libopencv_imgcodecs.so",
    "-l:libopencv_imgproc.so",
    "-l:libopencv_video.so",
    "-l:libopencv_videoio.so",
  ],
)

    現在の FFmpeg の設定は ffmpeg_linux.BUILD で定義されており、どのアーキテクチャでも機能します。

    # WORKSPACE
new_local_repository(
  name = "linux_ffmpeg",
  build_file = "@//third_party:ffmpeg_linux.BUILD",
  path = "/usr"
)

# ffmpeg_linux.BUILD for FFmpeg installed from Debian package
cc_library(
  name = "libffmpeg",
  linkopts = [
    "-l:libavcodec.so",
    "-l:libavformat.so",
    "-l:libavutil.so",
  ],
)

  4. GPU アクセラレーションを使用して、Linux でのみ（OS X では使用しない）デスクトップの例を実行する場合。

    # Requires a GPU with EGL driver support.
# Can use mesa GPU libraries for desktop, (or Nvidia/AMD equivalent).
sudo apt-get install mesa-common-dev libegl1-mesa-dev libgles2-mesa-dev

# To compile with GPU support, replace
--define MEDIAPIPE_DISABLE_GPU=1
# with
--copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11
# when building GPU examples.

  5. C++ の Hello World の例を実行します。

    $ export GLOG_logtostderr=1

# if you are running on Linux desktop with CPU only
$ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

# If you are running on Linux desktop with GPU support enabled (via mesa drivers)
$ bazel run --copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11 \
    mediapipe/examples/desktop/hello_world:hello_world

# Should print:
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!

ビルドエラーが発生した場合は、トラブルシューティングで、一般的なビルドの問題の解決策を確認してください。

CentOS へのインストール

免責条項: CentOS で MediaPipe を実行するのは試験運用版です。

  1. Bazelisk をインストールします。

    公式の Bazel ドキュメントに沿って Bazelisk をインストールします。

  2. MediaPipe リポジトリをチェックアウトします。

    $ git clone --depth 1 https://github.com/google/mediapipe.git

# Change directory into MediaPipe root directory
$ cd mediapipe

  3. OpenCV をインストールします。

    方法 1. パッケージ マネージャー ツールを使用して、事前コンパイル済みバージョンをインストールします。

    $ sudo yum install opencv-devel

    方法 2. ソースコードから OpenCV をビルドする。

    new_local_repository(
    name = "linux_opencv",
    build_file = "@//third_party:opencv_linux.BUILD",
    path = "/usr/local",
)

new_local_repository(
    name = "linux_ffmpeg",
    build_file = "@//third_party:ffmpeg_linux.BUILD",
    path = "/usr/local",
)

cc_library(
    name = "opencv",
    srcs = glob(
        [
            "lib/libopencv_core.so",
            "lib/libopencv_highgui.so",
            "lib/libopencv_imgcodecs.so",
            "lib/libopencv_imgproc.so",
            "lib/libopencv_video.so",
            "lib/libopencv_videoio.so",
        ],
    ),
    hdrs = glob([
        # For OpenCV 3.x
        "include/opencv2/**/*.h*",
        # For OpenCV 4.x
        # "include/opencv4/opencv2/**/*.h*",
    ]),
    includes = [
        # For OpenCV 3.x
        "include/",
        # For OpenCV 4.x
        # "include/opencv4/",
    ],
    linkstatic = 1,
    visibility = ["//visibility:public"],
)

cc_library(
    name = "libffmpeg",
    srcs = glob(
        [
            "lib/libav*.so",
        ],
    ),
    hdrs = glob(["include/libav*/*.h"]),
    includes = ["include"],
    linkopts = [
        "-lavcodec",
        "-lavformat",
        "-lavutil",
    ],
    linkstatic = 1,
    visibility = ["//visibility:public"],
)

  4. C++ の Hello World の例を実行します。

    $ export GLOG_logtostderr=1
# Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' if you are running on Linux desktop with CPU only
$ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

# Should print:
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!

ビルドエラーが発生した場合は、トラブルシューティングで、一般的なビルドの問題の解決策を確認してください。

macOS へのインストール

  1. 事前作業:

    • Homebrew をインストールします。
    • xcode-select --install を使用して Xcode とそのコマンドライン ツールをインストールします。

  2. Bazelisk をインストールします。

    公式の Bazel ドキュメントに沿って Bazelisk をインストールします。

  3. MediaPipe リポジトリをチェックアウトします。

    $ git clone --depth 1 https://github.com/google/mediapipe.git

$ cd mediapipe

  4. OpenCV と FFmpeg をインストールします。

    方法 1. HomeBrew パッケージ管理システムを使用して、プリコンパイル済みの OpenCV 3 ライブラリをインストールします。FFmpeg は OpenCV 経由でインストールされます。

    $ brew install opencv@3

# There is a known issue caused by the glog dependency. Uninstall glog.
$ brew uninstall --ignore-dependencies glog

    方法 2. MacPorts パッケージ マネージャー ツールを使用して OpenCV ライブラリをインストールします。

    $ port install opencv

    new_local_repository(
    name = "macos_opencv",
    build_file = "@//third_party:opencv_macos.BUILD",
    path = "/opt",
)

new_local_repository(
    name = "macos_ffmpeg",
    build_file = "@//third_party:ffmpeg_macos.BUILD",
    path = "/opt",
)

cc_library(
    name = "opencv",
    srcs = glob(
        [
            "local/lib/libopencv_core.dylib",
            "local/lib/libopencv_highgui.dylib",
            "local/lib/libopencv_imgcodecs.dylib",
            "local/lib/libopencv_imgproc.dylib",
            "local/lib/libopencv_video.dylib",
            "local/lib/libopencv_videoio.dylib",
        ],
    ),
    hdrs = glob(["local/include/opencv2/**/*.h*"]),
    includes = ["local/include/"],
    linkstatic = 1,
    visibility = ["//visibility:public"],
)

cc_library(
    name = "libffmpeg",
    srcs = glob(
        [
            "local/lib/libav*.dylib",
        ],
    ),
    hdrs = glob(["local/include/libav*/*.h"]),
    includes = ["local/include/"],
    linkopts = [
        "-lavcodec",
        "-lavformat",
        "-lavutil",
    ],
    linkstatic = 1,
    visibility = ["//visibility:public"],
)

  5. Python 3 と Python の「six」ライブラリがインストールされていることを確認します。

    $ brew install python
$ sudo ln -s -f /usr/local/bin/python3.7 /usr/local/bin/python
$ python --version
Python 3.7.4
$ pip3 install --user six

  6. C++ の Hello World の例を実行します。

    $ export GLOG_logtostderr=1
# Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' as desktop GPU is currently not supported
$ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

# Should print:
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!

ビルドエラーが発生した場合は、トラブルシューティングを参照して、ビルドに関する一般的な問題の解決策を確認してください。

Windows へのインストール

免責条項: Windows で MediaPipe を実行するのは試験運用版です。

  1. MSYS2 をインストールし、%PATH% 環境変数を編集します。

    MSYS2 が C:\msys64 にインストールされている場合は、C:\msys64\usr\bin を %PATH% 環境変数に追加します。

  2. 必要なパッケージをインストールします。

    C:\> pacman -S git patch unzip

  3. Python をインストールし、実行可能ファイルが %PATH% 環境変数を編集できるようにします。

    https://www.python.org/downloads から Python Windows 実行可能ファイルをダウンロードしてインストールします。

  4. Visual C++ Build Tools 2019 と WinSDK をインストールする

    VisualStudio のウェブサイトにアクセスしてビルドツールをダウンロードし、Microsoft Visual C++ 2019 再頒布可能パッケージと Microsoft Build Tools 2019 をインストールします。

    Microsoft の公式ウェブサイトから WinSDK をダウンロードしてインストールします。

  5. Bazel または Bazelisk をインストールし、Bazel 実行可能ファイルの場所を %PATH% 環境変数に追加します。

    方法 1. Bazel の公式ドキュメントに沿って、Bazel 6.5.0 以降をインストールします。

    方法 2. 公式の Bazel ドキュメントに沿って Bazelisk をインストールします。

  6. Bazel 変数を設定します。「Build on Windows」の詳細については、Bazel の公式ドキュメントをご覧ください。

    # Please find the exact paths and version numbers from your local version.
C:\> set BAZEL_VS=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools
C:\> set BAZEL_VC=C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC
C:\> set BAZEL_VC_FULL_VERSION=<Your local VC version>
C:\> set BAZEL_WINSDK_FULL_VERSION=<Your local WinSDK version>

  7. MediaPipe リポジトリをチェックアウトします。

    C:\Users\Username\mediapipe_repo> git clone --depth 1 https://github.com/google/mediapipe.git

# Change directory into MediaPipe root directory
C:\Users\Username\mediapipe_repo> cd mediapipe

  8. OpenCV をインストールします。

    https://opencv.org/releases/ から Windows 実行可能ファイルをダウンロードしてインストールします。MediaPipe 0.10.x は OpenCV 3.4.10 をサポートします。OpenCV が C:\opencv にインストールされていない場合は、WORKSPACE ファイルを編集してください。

    new_local_repository(
    name = "windows_opencv",
    build_file = "@//third_party:opencv_windows.BUILD",
    path = "C:\\<path to opencv>\\build",
)

  9. C++ の Hello World の例を実行します。

    C:\Users\Username\mediapipe_repo>bazel build -c opt --define MEDIAPIPE_DISABLE_GPU=1 --action_env PYTHON_BIN_PATH="C://python_36//python.exe" mediapipe/examples/desktop/hello_world

C:\Users\Username\mediapipe_repo>set GLOG_logtostderr=1

C:\Users\Username\mediapipe_repo>bazel-bin\mediapipe\examples\desktop\hello_world\hello_world.exe

# should print:
# I20200514 20:43:12.277598  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.278597  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.279618  1200 hello_world.cc:56] Hello World!
# I20200514 20:43:12.280613  1200 hello_world.cc:56] Hello World!

ビルドエラーが発生した場合は、トラブルシューティングを参照して、ビルドに関する一般的な問題の解決策を確認してください。

Windows Subsystem for Linux（WSL）へのインストール

  1. 手順に沿って Windows Subsystem for Linux（Ubuntu）をインストールします。

  2. Windows で Windows ADB をインストールし、ADB サーバーを起動します。

  3. WSL を起動します。

  4. 必要なパッケージをインストールします。

    username@DESKTOP-TMVLBJ1:~$ sudo apt-get update && sudo apt-get install -y build-essential git python zip adb openjdk-8-jdk

  5. Bazelisk をインストールします。

    公式の Bazel ドキュメントに沿って Bazelisk をインストールします。

  6. MediaPipe リポジトリをチェックアウトします。

    username@DESKTOP-TMVLBJ1:~$ git clone --depth 1 https://github.com/google/mediapipe.git

username@DESKTOP-TMVLBJ1:~$ cd mediapipe

  7. OpenCV と FFmpeg をインストールします。

    方法 1. パッケージ マネージャー ツールを使用して、事前コンパイル済みの OpenCV ライブラリをインストールします。FFmpeg は libopencv-video-dev を介してインストールされます。

    username@DESKTOP-TMVLBJ1:~/mediapipe$ sudo apt-get install libopencv-core-dev libopencv-highgui-dev \
                       libopencv-calib3d-dev libopencv-features2d-dev \
                       libopencv-imgproc-dev libopencv-video-dev

    方法 2. setup_opencv.sh を実行して、ソースから OpenCV を自動的にビルドし、MediaPipe の OpenCV 構成を変更します。

    オプション 3。OpenCV のドキュメントに沿って、ソースコードから OpenCV を手動でビルドします。

    new_local_repository(
    name = "linux_opencv",
    build_file = "@//third_party:opencv_linux.BUILD",
    path = "/usr/local",
)

cc_library(
    name = "opencv",
    srcs = glob(
        [
            "lib/libopencv_core.so",
            "lib/libopencv_highgui.so",
            "lib/libopencv_imgcodecs.so",
            "lib/libopencv_imgproc.so",
            "lib/libopencv_video.so",
            "lib/libopencv_videoio.so",
        ],
    ),
    hdrs = glob(["include/opencv4/**/*.h*"]),
    includes = ["include/opencv4/"],
    linkstatic = 1,
    visibility = ["//visibility:public"],
)

  8. C++ の Hello World の例を実行します。

    username@DESKTOP-TMVLBJ1:~/mediapipe$ export GLOG_logtostderr=1

# Need bazel flag 'MEDIAPIPE_DISABLE_GPU=1' as desktop GPU is currently not supported
username@DESKTOP-TMVLBJ1:~/mediapipe$ bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
    mediapipe/examples/desktop/hello_world:hello_world

# Should print:
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!

ビルドエラーが発生した場合は、トラブルシューティングで、一般的なビルドの問題の解決策を確認してください。

Docker を使用したインストール

これにより、mediapipe のインストールをシステムの他の部分から分離する Docker イメージが使用されます。

  1. ホストシステムに Docker をインストールします。

  2. タグ「mediapipe」を使用して Docker イメージをビルドします。

    $ git clone --depth 1 https://github.com/google/mediapipe.git
$ cd mediapipe
$ docker build --tag=mediapipe .

# Should print:
# Sending build context to Docker daemon  147.8MB
# Step 1/9 : FROM ubuntu:latest
# latest: Pulling from library/ubuntu
# 6abc03819f3e: Pull complete
# 05731e63f211: Pull complete
# ........
# See http://bazel.build/docs/getting-started.html to start a new project!
# Removing intermediate container 82901b5e79fa
# ---> f5d5f402071b
# Step 9/9 : COPY . /edge/mediapipe/
# ---> a95c212089c5
# Successfully built a95c212089c5
# Successfully tagged mediapipe:latest

  3. C++ の Hello World の例を実行します。

    $ docker run -it --name mediapipe mediapipe:latest

root@bca08b91ff63:/mediapipe# GLOG_logtostderr=1 bazel run --define MEDIAPIPE_DISABLE_GPU=1 mediapipe/examples/desktop/hello_world

# Should print:
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!
# Hello World!

ビルドエラーが発生した場合は、トラブルシューティングで、一般的なビルドの問題の解決策を確認してください。

  1. MediaPipe Android サンプルをビルドする。

    $ docker run -it --name mediapipe mediapipe:latest

root@bca08b91ff63:/mediapipe# bash ./setup_android_sdk_and_ndk.sh

# Should print:
# Android NDK is now installed. Consider setting $ANDROID_NDK_HOME environment variable to be /root/Android/Sdk/ndk-bundle/android-ndk-r19c
# Set android_ndk_repository and android_sdk_repository in WORKSPACE
# Done

root@bca08b91ff63:/mediapipe# bazel build -c opt --config=android_arm64 mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu:objectdetectiongpu

# Should print:
# Target //mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu:objectdetectiongpu up-to-date:
# bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu_deploy.jar
# bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu_unsigned.apk
# bazel-bin/mediapipe/examples/android/src/java/com/google/mediapipe/apps/objectdetectiongpu/objectdetectiongpu.apk
# INFO: Elapsed time: 144.462s, Critical Path: 79.47s
# INFO: 1958 processes: 1 local, 1863 processwrapper-sandbox, 94 worker.
# INFO: Build completed successfully, 2028 total actions