본문 바로가기
dev-setup

[.whl] Install Package with '.whl'

by doraemin_dev 2025. 4. 10.

pip install로 패키지를 인터넷에서 다운받아오는 것이 아닌,

.whl을 활용하여 (인터넷 없이도) 패키지를 다운받아보자!!

 

1. .whl 파일을 jupyter notebook이 위치한 곳으로 이동시키자.

linux ubuntu 서버 터미널에 명령어 입력.

sudo cp -r "/home/ubuntu/pip_pkgs/패키지파일명.whl" /home/ubuntu/workspace/nasw/download/

.whl 파일이 전달되어왔다!

2. 이제 .whl 파일을 활용해 패키지를 다운받자!

!pip install 패키지경로

 

이렇게 하면 보통은 패키지를 사용할 수 있다~


 

근데,, .whl의 python version과 현재 나의 python version이 안 맞으면 안된다. 

에러 메시지:

ERROR: pandas-2.2.3-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl is not a supported wheel on this platform.

해석

  • cp39-cp39 → Python 3.9 용으로 만들어진 wheel 파일
  • 그런데 지금 Jupyter Notebook 환경은 Python 3.11.x

Python wheel 파일은 Python 버전이 다르면 설치할 수 없습니다.
(cp39 은 Python 3.9, cp311 이 Python 3.11)

→ 그래서 "is not a supported wheel on this platform" 오류가 나는 거예요.


결론

현재 들고 계신 .whl 파일들이 Python 3.9 용이고,
현재 Jupyter 환경은 Python 3.11 이라 설치 자체가 안 됩니다.
파이썬 wheel 은 버전 의존성이 강해서, 같은 메이저 버전이어도 빌드 버전이 달라도 안 됩니다.