MediaPipe 설치 (Python 환경)

MediaPipe 설치 (Python 환경)

MediaPipe를 로컬 개발 환경에 설치하는 과정을 볼게요. 특히 Python 환경을 기준으로 어떤 단계를 거치는지 살펴보면, 나만의 프로젝트에 붙이기 쉬워져요.

출처: MediaPipe 설치 문서

MediaPipe 프레임워크를 직접 빌드해 쓰려면 크게 세 가지가 준비돼야 해요. 먼저 Bazel/Bazelisk(빌드 도구), 다음으로 MediaPipe 저장소 클론, 마지막으로 OpenCV와 FFmpeg 같은 영상 처리 의존성 순서예요.

MediaPipe 저장소는 아래처럼 클론할 수 있어요.

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

영상 처리를 위한 OpenCV와 FFmpeg는 두 가지 방법으로 설치할 수 있어요. 패키지 매니저로 미리 빌드된 OpenCV를 설치하는 방법이 있고, setup_opencv.sh 스크립트를 실행해 자동으로 소스에서 빌드하는 방법이 있어요. GPU 없이 CPU만으로 데스크톱 예시를 돌려보고 싶다면 아래처럼 MEDIAPIPE_DISABLE_GPU 플래그를 써요.

export GLOG_logtostderr=1
bazel run --define MEDIAPIPE_DISABLE_GPU=1 \
  mediapipe/examples/desktop/hello_world:hello_world

GPU 지원이 있는 리눅스 데스크톱이라면 mesa 드라이버용 플래그를 추가해 실행해요.

bazel run --copt -DMESA_EGL_NO_X11_HEADERS --copt -DEGL_NO_X11 \
  mediapipe/examples/desktop/hello_world:hello_world

이 예시가 성공하면 Hello World!가 여러 번 출력돼요. 다만 이건 프레임워크를 직접 빌드하는 고급 경로이고, 대부분의 프로젝트는 준비된 Tasks API를 pip로 설치해서 훨씬 쉽게 시작할 수 있다는 점을 기억해 두세요.

더 알아보기

• MediaPipe 설치 문서
• google-ai-edge/mediapipe