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 키가 필요해요. 발급 방법은 간단합니다:
- platform.openai.com 접속
- 회원가입 또는 로그인
- 우측 상단 프로필 → “View API keys” 클릭
- “Create new secret key” 버튼 클릭
- 키 이름 입력하고 생성
생성된 키는 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 providedAPI 키가 잘못됐거나 .env 파일 경로가 틀린 경우예요. 키를 다시 확인해보세요.
RateLimitError
openai.RateLimitError: You exceeded your current quotaOpenAI 무료 크레딧을 다 쓴 경우예요. 결제 정보를 등록하거나 새 계정을 만들어야 해요.
운영자 실전 노트
실제 프로젝트 진행하며 겪은 문제
- langchain 설치했는데 langchain-openai 없어서 import 에러 → 필요한 패키지 따로 설치해야 함
- 가상환경 안 쓰다가 전역 패키지 꼬여서 재설치 → 프로젝트마다 venv 무조건 만들기
- API 키 Github에 올려서 당일 $50 과금 → .gitignore에 .env 추가 필수
이 경험을 통해 알게 된 점
- 패키지 의존성 체크:
pip list | grep langchain으로 설치된 패키지 확인 - API 키 보안: .env 파일 + .gitignore 조합이 최선, credentials 폴더에 따로 관리도 좋음
정리
오늘 한 작업을 정리하면:
- Python 버전 확인 (3.9 이상)
- 가상 환경 생성 및 활성화
- LangChain 패키지 설치
- OpenAI API 키 발급
- .env 파일로 환경 변수 설정
- 첫 번째 코드 실행
환경 설정이 가장 귀찮은 부분인데, 한번 해두면 끝이다.
.env 파일 관리가 진짜 중요하다. 실수로 API 키 코드에 하드코딩했다가 깃허브에 올려서 요금 폭탄 맞은 사람 주변에서 몇 명 봤거든요. 꼭 환경변수로 관리하자.
다음 글에서는 프롬프트 템플릿을 사용해서 좀 더 유연한 질문을 만드는 방법을 알아본다!