본문 바로가기
내컴퓨터/컴퓨터사용하기

파이썬 라이브러리 수동 설치 방법

by 글쓴e 2025. 2. 27.

파이썬은 강력한 패키지 관리 시스템을 제공하지만, 특정 환경에서는 수동으로 라이브러리를 설치해야 하는 경우가 있습니다. 이번 글에서는 파이썬 라이브러리 수동 설치 방법을 상세히 알아보겠습니다.

목차

1. 파이썬 라이브러리 수동 설치가 필요한 경우

일반적으로 pip을 이용해 라이브러리를 설치하지만, 다음과 같은 상황에서는 수동 설치가 필요할 수 있습니다.

  • 특정 버전의 라이브러리를 설치해야 할 때
  • 인터넷 연결 없이 오프라인 환경에서 설치해야 할 때
  • 패키지 관리자(pip, conda)가 정상적으로 동작하지 않을 때
  • 비공식 패키지를 설치해야 할 때

2. 파이썬 라이브러리 수동 설치 방법

2.1 PyPI에서 라이브러리 다운로드

  1. Python Package Index(PYPI)에 접속합니다.
  2. 원하는 라이브러리를 검색합니다.
  3. 라이브러리 페이지에서 .tar.gz 또는 .whl 파일을 다운로드합니다.

2.2 압축 파일 직접 설치

다운로드한 .tar.gz 파일을 설치하려면 다음 단계를 따릅니다.

# tar.gz 파일 압축 해제
$ tar -xvzf package-name.tar.gz
$ cd package-name

# setup.py를 이용한 설치
$ python setup.py install

2.3 WHL 파일 설치

.whl 파일은 pip을 사용하여 쉽게 설치할 수 있습니다.

$ pip install package-name.whl

만약 pip이 동작하지 않는다면 python -m pip install 명령어를 사용하면 됩니다.

$ python -m pip install package-name.whl

2.4 GitHub에서 직접 설치

일부 오픈소스 라이브러리는 GitHub에서 직접 다운로드하여 설치해야 할 수도 있습니다.

$ git clone https://github.com/user/repository.git
$ cd repository
$ python setup.py install

3. 의존성 문제 해결 방법

수동 설치 시 의존성 문제가 발생할 수 있습니다. 이를 해결하기 위해 다음과 같은 방법을 사용합니다.

  • requirements.txt 파일이 제공되는 경우, 다음 명령어로 의존성을 한 번에 설치할 수 있습니다.
  • $ pip install -r requirements.txt
  • 특정 패키지가 필요할 경우 직접 설치합니다.
  • $ pip install dependency-package-name

4. 가상 환경을 활용한 수동 설치

가상 환경을 사용하면 라이브러리를 안전하게 관리할 수 있습니다.

$ python -m venv myenv
$ source myenv/bin/activate  # (Windows의 경우 myenv\Scripts\activate)
$ pip install package-name.whl

이렇게 하면 시스템의 다른 라이브러리와 충돌 없이 수동 설치한 패키지를 관리할 수 있습니다.

5. 설치된 라이브러리 확인 및 삭제

5.1 설치된 라이브러리 목록 확인

$ pip list

또는 특정 라이브러리의 정보를 확인하려면 다음 명령어를 사용합니다.

$ pip show package-name

5.2 라이브러리 삭제

설치된 라이브러리를 제거하려면 다음과 같이 실행합니다.

$ pip uninstall package-name

6. 마무리

이번 글에서는 파이썬 라이브러리 수동 설치 방법을 다양한 방식으로 알아보았습니다.

라이브러리 설치가 잘 되지 않을 경우, pip을 최신 버전으로 업데이트하거나 가상 환경을 활용하는 것이 좋은 방법입니다. 이를 활용하면 다양한 환경에서도 원활하게 개발을 진행할 수 있습니다!