pip로 Python 모듈·패키지 손쉽게 설치하는 방법 (설치부터 버전 지정까지)

pip란 무엇인가?

pip는 Python의 공식 패키지 관리 도구로, PyPI(Python Package Index)에 등록된 수많은 라이브러리와 모듈을 명령어 한 줄로 설치하고 관리할 수 있게 해줍니다. Python 개발 환경을 구축할 때 가장 먼저 익혀야 할 필수 도구입니다.

1. pip 설치 여부 확인 및 최신 버전으로 업그레이드

python.org에서 Python 2.7.9 이상 또는 Python 3.4 이상을 설치했다면 pip와 setuptools가 이미 함께 포함되어 있습니다. 다만 안정성과 보안을 위해 최신 버전으로 업그레이드하는 것을 권장합니다.

Linux 또는 macOS에서 업그레이드

pip install -U pip setuptools

Windows에서 업그레이드

python -m pip install -U pip setuptools

💡 Windows에서는 pip 명령이 PATH에 등록되지 않은 경우가 많으므로, python -m pip 형태로 실행하는 것이 가장 안전합니다.

2. 시스템 패키지 관리자로 Python을 설치한 경우

Linux에서 yum, apt-get 등 시스템 패키지 관리자가 관리하는 Python을 사용 중이라면, pip 역시 해당 패키지 관리자를 통해 설치하거나 업그레이드하는 것이 좋습니다. 자세한 내용은 아래 공식 가이드를 참고하세요.

• 공식 문서: Installing using Linux tools (packaging.python.org)

3. pip가 없다면? get-pip.py로 직접 설치하기

위 방법으로 pip를 사용할 수 없는 환경이라면 부트스트랩 스크립트를 이용해 간단히 설치할 수 있습니다.

1. https://bootstrap.pypa.io/get-pip.py에서 get-pip.py 파일을 다운로드합니다.
2. 터미널(또는 명령 프롬프트)에서 아래 명령을 실행합니다.

python get-pip.py

이 스크립트는 pip가 없으면 새로 설치하고, 기존 버전이 있다면 최신 버전으로 업그레이드해 줍니다.

4. pip로 Python 패키지 설치하기

pip 준비가 끝났다면 이제 원하는 패키지를 자유롭게 설치할 수 있습니다.

최신 버전 설치

$ pip install 'SomeProject'

특정 버전 설치

$ pip install 'SomeProject==1.4'

버전 범위 지정 설치 (1 이상 2 미만)

$ pip install 'SomeProject>=1,<2'

이처럼 pip는 단순 설치뿐 아니라 버전 고정(==)과 범위 지정(>=, <)도 지원하므로, 프로젝트별 의존성 관리에 매우 유용합니다. 실무에서는 requirements.txt 파일과 함께 사용하면 팀 전체가 동일한 개발 환경을 유지할 수 있습니다.