[LLM] - LLM 사용 전 Python 환경 설정(Pyenv, Poetry)

LLM(대규모 언어 모델) 프로젝트를 시작하기 전에 Python 버전 관리와 환경 설정이 필요하다. 다양한 라이브러리와 패키지의 의존성 문제를 방지하려면 pyenv랑 Poetry를 활용하는 게 좋다. 그래서 내가 pyenv랑 Poetry 설정 과정을 기록해 본다.

Pyenv 란?

• 여러 Python 버전을 설치하고 관리할 수 있는 도구다.
• 프로젝트마다 다른 Python 버전이 필요할 때 유용하다.
• 한 시스템에서 다양한 버전을 쉽게 전환할 수 있다.
• 프로젝트의 일관성을 유지할 수 있다.

Poety란?

• Python 프로젝트의 의존성을 관리할 수 있는 도구다.
• 가상환경 설정 기능을 제공한다.
• 프로젝트별 패키지 관리와 의존성 문제를 해결할 수 있다.
• 안정적인 개발 환경을 만드는 데 도움이 된다.

Pyenv로 Python 버전 관리하기 전 준비 단계

1.  터미널 / 명령어 창 열기
   Window에서는 cmd, PowerShell
   macOS, Linux에는 Terminal을 사용
2. Pyenv 설치
   ● windows 사용자는 다음 명령어를 통해 pyenv-win을 설치
   

   git clone https://github.com/pyenv-win/pyenv-win.git "$env:USERPROFILE\.pyenv"

3. 환경 변수 설정
   ● PowerShell을 열고 다음 명령어를 실행하여 환경 변수를 추가.
   

   [System.Environment]::SetEnvironmentVariable('PYENV', $env:USERPROFILE + "\.pyenv\pyenv-win\", 'User')
   [System.Environment]::SetEnvironmentVariable('PYENV_ROOT', $env:USERPROFILE + "\.pyenv\pyenv-win\", 'User')
   [System.Environment]::SetEnvironmentVariable('PYENV_HOME', $env:USERPROFILE + "\.pyenv\pyenv-win\", 'User')

   
   ● PATH 환경 변수도 추가
   

   [System.Environment]::SetEnvironmentVariable('PATH', $env:USERPROFILE + "\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('PATH', 'User'), 'User')

   
   ● 설정 후 명령어 창을 다시 연다

Pyenv로 Python 버전 관리하기

1. Python 버전 설정
   

   pyenv install 3.11.9
   pyenv global 3.11.9

2. Python 버전 확인
   ● 설정 후 Python 버전 확인하기
   

   python --version

   ● 올바른 버전이 출력되어야 한다
   ● 예상과 다른 버전이 출력이 된다면 다른 환경이 세팅 되어 있을 수 있다 ex) 아나콘다(Anaconda)
   ● 예상과 다른 버전이 출력이 된다면 다른 버전의 파이썬을 이미 다운로드해서 환경 변수에 먼저 연결된 걸 수도 있다.

Conda 환경이 켜져 있을 때 문제 해결하기

1. Conda 환경 비활성화
   ● 아나콘다 환경이 켜져 있으면 (base) 혹은 설정한 (환경변수 이름) 표시가 보인다.
   ● 이를 비활성화하려면 다음 명령어를 사용한다.
   

   conda deactivate

2. 다시 Python 버전 확인
   ● Conda 환경을 껏으면 다시 Python 버전을 확인해본다
   

   python --version

Pyenv 설정 후에도 버전 문제 해결하기

• pyenv로 Python 3.11.9를 설정했는데도 3.11.7 버전이 계속 뜬다면, 과거에 설치된 Python이 환경 변수에서 우선 연결된 걸 수 있다.
• 환경 변수를 확인하고 경로를 조정하거나 불필요한 버전을 삭제하면 된다.

Poetry를 통한 의존성 관리

• Poetry는 프로젝트의 패키지 의존성을 관리하는 데 아주 유용하다.
  
• 아나콘다 환경을 쓰지 않는 이유는 의존성 충돌이나 버전 차이로 인한 문제를 피하기 위해서다.

1. Poetry 설치
   

   pip install --user poetry

   
   ● 설치가 안 된다면 pip3 실행 파일이 남아 있을 수도 있다
   ● 이 경우 해당 파일을 삭제한다
   

   C:\Users\thdgh\AppData\Local\Programs\Python\Python311\Scripts\pip3.exe

2. 프로젝트 클론 및 환경 설정
   ● 프로젝트를 클론하고 가상환경을 설정한다. (Youtube - teddynote)
   

   cd C:\Users\thdgh\Documents
   git clone https://github.com/teddylee777/langchain-kr.git
   cd langchain-kr
   poetry shell

3.  패키지 업데이터
   ● 모든 패키지를 최신 버전으로 업데이트 한다.
   

   poetry update