インストール

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. プリコンパイル済みのバージョンをインストールするには、Package Manager ツールを使用してください。

   $ 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.1.1 以降をインストールします。

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

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

   # 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 ADB をインストールし、Windows で 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 を手動でビルドします。

   WORKSPACEWORKSPACE の "open_local_repository}opencv_linux.BUILDlike ルール（cc_2}

   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!