[오류] M1 Mac에서 Python MediaPipe 설치 중 OpenCV 관련 오류

M1 Mac에서의 Python MediaPipe 설치는 전부터 알려진 문제들이 계속 발생하는 듯 하다.

2021년 상반기에 발견된 이슈에 대해 개발자들이 인지는 하고 있는 듯 하나 아직까지 해결되진 않은 듯...

 

https://github.com/cansik/mediapipe-silicon

임시로 위의 mediapipe-silicon을 설치하여 사용하는 방법이 있긴 하다. 아래의 명령어를 통해 패키지 설치가 가능하긴 하나 업데이트에 따라 호환 문제가 생길 여지가 있음에 유의하여 사용하자.

pip install mediapipe-python

 

본 글에서는 공식 페이지의 수동 패키지 설치 관련 오류에 대해 적는다.

 

---

 

설치 가이드를 따랐으나 아래와 같이 'opencv2/core/version.hpp' file not found  문제가 발생하는 상황에 대한 해결

 

 

 

문제 상황

 

2022년 11월 M1 Ventura 13.0 기준, pip을 통해 Python MediaPipe 설치를 시도했으나 아래와 같이 적당한 버전이 존재하지 않는다며 오류 발생. Python 3.8.15 및 3.10을 모두 시도해보았으나 동일한 오류 발생.

 

 

 

공식 사이트의 Troubleshooting 페이지를 보아도 파이썬 버전 3.7~3.10과 macOS 10.15+를 맞게 사용하는 상황.

 

 

https://google.github.io/mediapipe/getting_started/troubleshooting.html#incorrect-mediapipe-opencv-config

공식 페이지에서는 pip을 통한 설치를 강력히 권장하나 별도의 방법이 없어 직접 아래의 가이드를 따라 Python Package를 빌드하는 과정에서 6번을 시도하던 도중 'opencv2/core/version.hpp' file not found 에러가 뜨며 설치가 종료된다.

 

 

 

https://google.github.io/mediapipe/getting_started/python.html#building-mediapipe-python-package

 

 

 

문제 해결

 

깃헙에서 관련된 이슈를 오래 찾아보고 나서야 원인을 발견, 해결하신 분들의 말에 따르면 M1의 경우 빌드 파일에서 opencv를 macos build 대신 linux build를 적용하기 때문이라 한다. 본인은 빌드 파일을 직접 수정하는 방법으로 해결했으므로 이 방법을 소개한다. issue의 LluisColom의 해결법을 적용했다.

 

https://github.com/google/mediapipe/issues/3440

github에서 clone 한 MediaPipe/WORKSPACE 의 new_local_repository의 macos와 관련된 부분의 path를 아래와 같이 homebrew에 대한 경로로 수정 시 정상적으로 python3 setup.py install --link-opencv 명령이 실행된다.