생성형 AI 기반
RAG 개발자 과정

Session 0 / 33 — OT + 개발환경

LLM 이론 · LangChain · ChromaDB CRUD · Agent — 4일 핸즈온

박수현 · (사)한국정보공학기술사회 · 2026

4일을 마치면 만들 수 있는 것

📦 강의 자료 & 실습 예제 다운로드

대상 학습자

🔑 코스 목표

"4일 안에 직접 가진 데이터로 RAG + Agent 데모를 돌리는 것."

4일 × 33세션 전체 지도

🎯 흐름: 이론(왜) → API·챗봇 → RAG 개념 → LangChain RAG → 웹서비스화(CRUD) → 자율성(Agent)

PART A
개발환경 셋업

conda 환경 · 의존성 · .env · IDE — 약 50분

Python 3.12 — 본 코스 권장 버전

conda 설치 — Miniconda vs Anaconda

💻 OS 별 설치 (Miniconda 기준)

# macOS (Apple Silicon)
brew install --cask miniconda

# Linux
wget https://repo.anaconda.com/miniconda/Miniconda3-latest-Linux-x86_64.sh
bash Miniconda3-latest-Linux-x86_64.sh

# Windows
# 위 URL 에서 .exe 다운로드 → 더블클릭 설치
# "Add Miniconda3 to PATH" 체크 권장 (개발자라면 OK)

py312_gpt 환경 만들기

명령어 세 줄이면 끝

# 1. 환경 생성 — Python 3.12
conda create -n py312_gpt python=3.12 -y

# 2. 활성화
conda activate py312_gpt

# 3. 확인
python --version          # → Python 3.12.x
which python              # → ~/miniconda3/envs/py312_gpt/bin/python

자주 만나는 셸 이슈

# conda activate 가 동작하지 않을 때 (bash/zsh)
conda init bash           # 또는 zsh
exec $SHELL               # 셸 재시작 없이 반영

# Windows PowerShell
conda init powershell
# 그런 다음 PowerShell 재시작

💡 환경 이름 규칙: 본 코스의 모든 코드/README 가 py312_gpt 를 가정합니다. 다른 이름을 쓰면 안내 명령의 환경명을 그에 맞게 바꿔 쓰세요.

핵심 의존성 한 번에

conda activate py312_gpt

# Day 1 ~ Day 3 전체 의존성
pip install \
    openai==1.* \
    anthropic==0.40.* \
    python-dotenv \
    flask requests tiktoken \
    langchain==1.* \
    langchain-openai \
    langchain-anthropic \
    langchain-community \
    langchain-text-splitters \
    langchain-chroma \
    faiss-cpu chromadb pypdf \
    sentence-transformers \
    langgraph \
    wikipedia duckduckgo-search

python -c "
import openai, anthropic, langchain, langgraph
import faiss, chromadb, tiktoken, pypdf
print('✅ 모든 핵심 패키지 import 성공')
print('openai:', openai.__version__)
print('langchain:', langchain.__version__)
"

본 코스 실습 코드

git clone https://github.com/lovehyun/tutorial-genai.git
cd tutorial-genai

📁 주요 폴더 매핑

📖 각 폴더에 README.md 가 있어 해당 폴더 내 파일별 학습 순서를 안내합니다. (실제 실습은 이 경로의 코드로 진행)

API Key 는 .env 에 — 코드에 하드코딩하지 말 것

# OpenAI
OPENAI_API_KEY=sk-proj-...

# Anthropic (Day 3 에서 사용)
ANTHROPIC_API_KEY=sk-ant-...

# Google Gemini (옵션)
GOOGLE_API_KEY=...

# LangSmith (옵션 — Agent 추적)
LANGCHAIN_TRACING_V2=true
LANGCHAIN_API_KEY=...

.env
.env.*
*.key

# pip install python-dotenv
from dotenv import load_dotenv
import os

# 같은 폴더의 .env
load_dotenv()

# 상위 폴더의 .env (1.openai/1.intro 에서 루트 .env 참조)
load_dotenv(dotenv_path='../.env')

api_key = os.getenv('OPENAI_API_KEY')

API Key — 깃(git)에 올리면 5분 안에 도용

🚨 사고 사례

• OpenAI: 한 학생이 API 키를 코드에 하드코딩한 채 git push → 2시간 만에 봇이 발견 → 약 600달러 누적
• AWS: 동일 패턴으로 EC2 마이닝 → 며칠 만에 수만 달러

PART B
IDE 선택

VS Code · Cursor · Claude Code — 약 10분

VS Code vs Cursor vs Claude Code

본 코스 강의 시연 환경

• VS Code + Python 확장 으로 시연 (가장 보편적)
• 다른 IDE 가 익숙하면 그걸로 진행해도 됩니다

본 코스에서 도움 되는 5가지

code --install-extension ms-python.python
code --install-extension ms-toolsai.jupyter
code --install-extension charliermarsh.ruff
code --install-extension mikestead.dotenv

Ctrl + Shift + P
  →  Python: Select Interpreter
  →  py312_gpt

PART C
첫 실행

Hello, LLM — 약 10분

코드 4줄로 첫 호출

hello_llm.py

from openai import OpenAI
client = OpenAI()  # OPENAI_API_KEY 는 환경변수에서 자동 인식

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "한 줄로 자기소개해줘"}],
)
print(resp.choices[0].message.content)

conda activate py312_gpt
cd tutorial-genai/1.openai/1.intro
python 3.sdk_new.py

저는 OpenAI 가 만든 인공지능 비서로,
다양한 질문에 답변하고 글쓰기·요약·
분석·코드 작성 같은 작업을 도와드립니다.

잘 안 될 때 — 디버그 체크리스트

가장 흔한 시나리오 (90%)

# 1. 어디서 실행 중인지 확인
which python              # → py312_gpt 가 아니면 활성화 누락

# 2. .env 가 같은 디렉토리에 있는지
ls -la .env

# 3. .env 에 키가 실제로 있는지 (값은 마스킹)
grep "^OPENAI" .env

오늘 정리 7가지

1. ✅ Python 3.12 + conda 환경 py312_gpt 생성
2. ✅ 핵심 의존성 (openai, langchain, chromadb 등) 설치
3. ✅ 소스 코드 클론 — tutorial-genai/
4. ✅ .env 에 OPENAI_API_KEY 저장 + .gitignore 등록
5. ✅ 결제 한도 (Soft $5, Hard $20) 설정
6. ✅ VS Code 인터프리터 선택 → py312_gpt
7. ✅ 첫 호출 — Hello, LLM 응답 확인

시작 전 — 점검 4가지

• [ ] conda activate py312_gpt 가 정상 동작
• [ ] OPENAI_API_KEY 가 .env 에 저장됨, Hard limit 설정됨
• [ ] python 3.sdk_new.py 실행해 출력 확인
• [ ] (옵션) ANTHROPIC_API_KEY 도 같이 발급 (Agent 실습용)

🎯 최종 점검

cd tutorial-genai
conda activate py312_gpt
python -c "
from openai import OpenAI
r = OpenAI().chat.completions.create(
    model='gpt-4o-mini',
    messages=[{'role':'user','content':'준비 완료?'}],
    max_tokens=20
)
print('✅', r.choices[0].message.content)
"

위 한 줄이 응답 출력되면 개발환경 준비 완료.
안 되면 슬라이드 18(트러블슈팅) 참고 또는 강사에게 화면 공유 요청.