LangChain 독학 가이드 2 - 개발 환경 설정

LangChain을 배우고 싶은데 어디서부터 시작해야 할지 모르겠다고요? 저도 처음엔 그랬어요. “Python은 설치했는데… 그다음은 뭐지?” 하면서 한참 헤맸거든요.

오늘은 완전 처음 시작하시는 분들을 위해, Python 확인부터 첫 번째 LangChain 코드 실행까지 차근차근 알려드릴게요.

Python 버전 확인하기

LangChain은 Python 3.9 이상이 필요해요. 먼저 내 컴퓨터에 Python이 설치되어 있는지, 버전은 몇인지 확인해볼게요.

터미널(명령 프롬프트)을 열고 다음 명령어를 입력하세요:

python --version

실행 결과:

3.9 이상이면 OK예요! 만약 Python이 없거나 버전이 낮다면 python.org에서 최신 버전을 다운로드하세요.

가상 환경 만들기

프로젝트마다 가상 환경을 만들어 쓰는 게 좋아요. 왜냐하면 패키지 버전이 꼬이는 걸 방지할 수 있거든요.

프로젝트 폴더를 만들고 가상 환경을 생성해볼게요:

# 프로젝트 폴더 생성
mkdir langchain-tutorial
cd langchain-tutorial

# 가상 환경 생성
python -m venv venv

실행 결과:

이제 가상 환경을 활성화해야 해요. 운영체제에 따라 명령어가 달라요:

# Windows
venv\Scripts\activate

# Mac / Linux
source venv/bin/activate

실행 결과:

앞에 (venv)가 붙으면 가상 환경이 활성화된 거예요!

LangChain 패키지 설치

이제 진짜 LangChain을 설치할 차례예요. 필요한 패키지들을 한번에 설치할게요:

pip install langchain langchain-openai langchain-community python-dotenv

실행 결과:

각 패키지가 뭔지 간단히 설명드릴게요:

• langchain: 핵심 라이브러리
• langchain-openai: OpenAI GPT 연동용
• langchain-community: 커뮤니티 도구 모음
• python-dotenv: 환경 변수 관리용

OpenAI API 키 발급받기

LangChain으로 GPT를 쓰려면 OpenAI API 키가 필요해요. 발급 방법은 간단합니다:

1. platform.openai.com 접속
2. 회원가입 또는 로그인
3. 우측 상단 프로필 → “View API keys” 클릭
4. “Create new secret key” 버튼 클릭
5. 키 이름 입력하고 생성

생성된 키는 sk- 로 시작해요. 이 키는 딱 한 번만 보여주니까 꼭 복사해두세요!

환경 변수 설정하기

API 키를 코드에 직접 쓰면 보안상 위험해요. .env 파일을 만들어서 관리하는 게 좋습니다.

프로젝트 폴더에 .env 파일을 만들고 다음 내용을 입력하세요:

OPENAI_API_KEY=sk-여기에-발급받은-키-입력

그리고 .gitignore 파일에 .env를 추가해서 Git에 올라가지 않도록 해주세요.

첫 번째 코드 실행하기

드디어 첫 번째 LangChain 코드를 실행해볼 시간이에요! main.py 파일을 만들고 다음 코드를 입력하세요:

from dotenv import load_dotenv
from langchain_openai import ChatOpenAI

# .env 파일에서 API 키 로드
load_dotenv()

# GPT-3.5 모델 초기화
llm = ChatOpenAI(model="gpt-3.5-turbo")

# 질문하고 답변 받기
response = llm.invoke("안녕! LangChain이 뭐야?")
print(response.content)

실행 결과:

와! 첫 번째 LangChain 코드가 성공적으로 실행됐어요!

자주 발생하는 오류와 해결법

ModuleNotFoundError

ModuleNotFoundError: No module named 'langchain'

가상 환경이 활성화 안 됐거나, 패키지 설치가 안 된 경우예요. pip install langchain을 다시 실행해보세요.

AuthenticationError

openai.AuthenticationError: Incorrect API key provided

API 키가 잘못됐거나 .env 파일 경로가 틀린 경우예요. 키를 다시 확인해보세요.

RateLimitError

openai.RateLimitError: You exceeded your current quota

OpenAI 무료 크레딧을 다 쓴 경우예요. 결제 정보를 등록하거나 새 계정을 만들어야 해요.

정리

오늘 한 작업을 정리하면:

1. Python 버전 확인 (3.9 이상)
2. 가상 환경 생성 및 활성화
3. LangChain 패키지 설치
4. OpenAI API 키 발급
5. .env 파일로 환경 변수 설정
6. 첫 번째 코드 실행

환경 설정이 가장 귀찮은 부분인데, 한번 해두면 끝이에요. 다음 글에서는 프롬프트 템플릿을 사용해서 좀 더 유연한 질문을 만드는 방법을 알아볼게요!

다음 글 보기