Установка

Установка на Debian и Ubuntu

  1. Установите Базелиск.

    Следуйте официальной документации 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 .

    ОС OpenCV
    Debian 9 (расширенная версия) 2.4
    Debian 10 (разрушитель) 3.2
    Debian 11 (яблочко) 4,5
    Убунту 16.04 ЛТС 2.4
    Убунту 18.04 ЛТС 3.2
    Убунту 20.04 ЛТС 4.2
    Убунту 20.04 ЛТС 4.2
    Убунту 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

    opencv_linux.BUILD и WORKSPACE MediaPipe уже настроены для 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 из исходного кода и изменить конфигурацию OpenCV MediaPipe. Этот параметр автоматически выполнит все шаги, определенные в Варианте 3.

    Вариант 3 . Следуйте документации OpenCV, чтобы вручную собрать OpenCV из исходного кода.

    Возможно, вам придется изменить WORKSPACE и opencv_linux.BUILD чтобы указать MediaPipe на ваши собственные библиотеки OpenCV. Предположим, 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. Для запуска примеров рабочего стола только в 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. Запустите Привет, мир! в примере С++ . 

    $ 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

Отказ от ответственности : запуск MediaPipe в CentOS является экспериментальным.

  1. Установите Базелиск.

    Следуйте официальной документации Bazel для установки Bazelisk.

  2. Оформить заказ репозитория MediaPipe. 

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

# Change directory into MediaPipe root directory
$ cd mediapipe

  3. Установите ОпенКВ.

    Вариант 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. Запустите Привет, мир! в примере С++ . 

    $ 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. Предварительная работа:

    • Установите Доморощенный .
    • Установите Xcode и его инструменты командной строки с помощью xcode-select --install .

  2. Установите Базелиск.

    Следуйте официальной документации 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. Запустите Привет, мир! в примере С++ . 

    $ 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

Отказ от ответственности : запуск MediaPipe в Windows является экспериментальным.

  1. Установите MSYS2 и отредактируйте переменную среды %PATH% .

    Если MSYS2 установлен в C:\msys64 , добавьте C:\msys64\usr\bin в переменную среды %PATH% .

  2. Установите необходимые пакеты. 

    C:\> pacman -S git patch unzip

  3. Установите Python и разрешите исполняемому файлу редактировать переменную среды %PATH% .

    Загрузите исполняемый файл Python для Windows с https://www.python.org/downloads и установите.

  4. Установите инструменты сборки Visual C++ 2019 и WinSDK.

    Перейдите на веб-сайт VisualStudio , загрузите инструменты сборки и установите распространяемый пакет Microsoft Visual C++ 2019 и Microsoft Build Tools 2019.

    Загрузите WinSDK с официального сайта Microsoft и установите.

  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. Установите ОпенКВ.

    Загрузите исполняемый файл Windows с https://opencv.org/releases/ и установите. MediaPipe 0.10.x поддерживает OpenCV 3.4.10. Не забудьте отредактировать файл WORKSPACE , если OpenCV не установлен в C:\opencv . 

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

  9. Запустите Привет, мир! в примере С++ .

    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 для Linux (WSL)

  1. Следуйте инструкциям по установке подсистемы Windows для Linux (Ubuntu).

  2. Установите Windows ADB и запустите сервер ADB в Windows.

  3. Запустите ВСЛ.

  4. Установите необходимые пакеты. 

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

  5. Установите Базелиск.

    Следуйте официальной документации 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 из исходного кода и изменить конфигурацию OpenCV MediaPipe.

    Вариант 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. Запустите Привет, мир! в примере С++ . 

    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

При этом будет использоваться образ Docker, который изолирует установку mediapipe от остальной системы.

  1. Установите Docker в вашей хост-системе.

  2. Создайте образ докера с тегом «mediapipe». 

    $ 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. Запустите Привет, мир! в примере С++ . 

    $ 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