패키지 설치, 그리고 버전을 묶어 두는 이유

패키지는 설치보다 버전을 적어 두는 일이 더 중요합니다. 오늘 되던 코드가 다음 달에 안 되는 이유는 대개 여기 있습니다.

최소 설치

python -m pip install --upgrade pip
pip install -U langchain langgraph

LangChain 공식 문서 기준 langchain은 Python 3.10 이상이 필요합니다. LangGraph 공식 설치 명령은 pip install -U langgraph입니다.

쓰는 모델에 따라 더 깔아야 하는 것

학습용 통합 설치

pip install -U \
  langchain \
  langgraph \
  langchain-openai \
  langsmith \
  python-dotenv \
  pydantic \
  pytest

Windows PowerShell에서는 한 줄로 입력하는 편이 편합니다.

pip install -U langchain langgraph langchain-openai langsmith python-dotenv pydantic pytest

LangGraph Studio 와 Local Agent Server

공식 문서 기준 Python 3.11 이상이 필요합니다.

pip install -U "langgraph-cli[inmem]"
langgraph dev

설치 확인

python -c "import langchain, langgraph; print('OK')"
pip show langchain
pip show langgraph

버전 스냅샷

학습팩이 기록한 2026-08-15 기준 버전입니다.

버전 고정의 두 얼굴 분석

개념. 버전 고정(pin)은 requirements.txt에 정확한 버전을 적어 두는 것입니다.

좋은 점. 검증한 버전과 실행 버전이 같음을 보장합니다. 어제 되던 코드가 오늘 안 되는 일이 줄어듭니다.

주의할 점. 고정해 두면 보안 패치도 자동으로 들어오지 않습니다. 취약점이 고쳐진 새 버전이 나와도 고정된 버전에 머뭅니다.

그래서 어떻게 하는가. 고정과 정기 갱신을 함께 운영합니다. 버전을 적어 두되, 정해진 주기로 새 버전을 확인하고 검증한 뒤 올립니다.