LangChain 설치하기

LangChain 설치하기 (Install LangChain)

LangChain을 쓰려면 가장 먼저 해야 할 일이 바로 패키지를 설치하는 거예요. 그런데 여기서 헷갈리기 쉬운 점이 하나 있어요. LangChain 자체는 꽤 가벼운 패키지인데, 실제로는 수백 개의 LLM과 수천 개의 통합(integration) 패키지가 따로 떨어져서 배포되고 있어요. 그래서 "LangChain만 설치하면 다 되는 거 아니야?"라고 생각했다면, 잠깐만요 — 그 구조부터 차근차근 설명해 드릴게요.

출처: LangChain 공식 문서 — install

기본 패키지 설치

가장 단순한 경로는 langchain 코어 패키지를 설치하는 거예요. Python 3.10 이상이 필요합니다. 패키지 매니저는 pip를 써도 되고, uv 같은 현대적인 도구를 써도 돼요.

pip install -U langchain
# Requires Python 3.10+

uv add langchain
# Requires Python 3.10+

-U 또는 uv add는 항상 최신 버전을 유지해 주는 옵션이에요. 새 프로젝트를 시작할 때는 이렇게 최신 상태로 설치하는 게 가장 안전하죠.

통합(integration) 패키지 설치하기

자, 이제 핵심 포인트예요. LangChain은 자체적으로 모델을 제공하지 않아요. OpenAI, Anthropic 같은 특정 제공자(provider)의 모델을 쓰려면 그 제공자 전용 통합 패키지를 따로 설치해야 합니다. 이렇게 분리해 둔 덕분에, 필요한 제공자만 골라서 설치할 수 있고 코어 패키지는 가볍게 유지되는 거예요.

# Installing the OpenAI integration
pip install -U langchain-openai

# Installing the Anthropic integration
pip install -U langchain-anthropic

# Installing the OpenAI integration
uv add langchain-openai

# Installing the Anthropic integration
uv add langchain-anthropic

통합 패키지 이름은 대부분 langchain-<provider> 형태라서 알아보기 쉬워요. 예를 들면 langchain-openai, langchain-anthropic 같은 식이죠.

전체 통합 목록은 Integrations 탭에서 확인할 수 있어요.

설치 후 할 일

설치가 끝났다면 이제 바로 시작할 준비가 된 거예요. Quickstart 가이드를 따라 첫 앱을 만들어 보는 걸 추천합니다.

디버깅을 위해선 LangSmith 추적(tracing)을 설정하는 것도 좋아요. 첫 LangChain 앱에서 무슨 일이 벌어지는지 눈으로 보려면 tracing quickstart를 따라 해보세요. 모델이 어떤 메시지를 받고, 어떤 도구를 호출했는지 한눈에 보이거든요.

LangChain 설치하기