PiWheels란?
PiWheels는 라즈베리파이에서 사용할 수 있도록 사전 빌드된 Python 패키지 저장소이다.
라즈베리파이는 ARM 아키텍처를 사용하기 때문에, 일반 PyPI에서 설치되는 패키지를 그대로 쓰기 어렵거나, 설치 시 빌드 과정에서 오랜 시간이 걸리는 경우가 많다.
이를 해결하기 위해, 라즈베리파이용으로 미리 빌드된.whl패키지를 제공하는 것이 바로 PiWheels다.
장점
- 설치 속도 빠름: 미리 빌드된 wheel 파일 제공
- 빌드 에러 방지: C/C++ 확장 포함된 패키지도 문제 없이 설치 가능
- 라즈베리파이 최적화: ARM 환경에서 바로 사용할 수 있도록 제공됨
단점
- 해시 오류 발생: PyPI 기준과의 버전/해시 mismatch로 설치 실패 가능
- 최신 패키지 누락: 최신 버전이 PiWheels에는 없을 수 있음
- 신뢰도 이슈: 일부 패키지는 내용 차이로 인한 실행 문제 발생 가능
직접 겪은 문제
라즈베리파이에서
pip install TTS를 진행하던 중 아래와 같은 오류가 발생했다:ERROR: THESE PACKAGES DO NOT MATCH THE HASHES FROM THE REQUIREMENTS FILE. Expected sha256 xxx Got sha256 yyy이는 PiWheels에서 내려받은 .whl 파일과 PyPI의 공식 해시값이 다르기 때문에 발생한 문제였다.
해결 방법
해당 패키지를 PyPI에서 직접 설치하도록 강제
# PiWheels 무시하고 PyPI에서 직접 설치 pip install --no-binary :all: 패키지이름
결론
PiWheels는 라즈베리파이에서 pip 설치를 빠르고 간편하게 만들어주는 유용한 도구이다.
하지만 특정 패키지에서는 해시 mismatch 오류나 최신 버전 미지원 문제가 발생할 수 있어, 때에 따라 PyPI에서 직접 설치하는 방식으로 우회가 필요하다.
TIL 요약
오늘은 Raspberry Pi 전용 패키지 저장소인 PiWheels에 대해 정리했다.
설치 속도는 빠르지만, 특정 패키지에서는hash mismatch오류가 날 수 있으므로
--no-binary옵션으로 PyPI에서 직접 설치하는 방법도 함께 익혀두면 좋다.
Backend Developer