외부 패키지와 가상환경 — 파이썬 프로젝트 관리

# 패키지 설치
pip install openai

# 특정 버전 설치
pip install openai==1.10.0

# 여러 패키지 한 번에
pip install openai langchain chromadb

# 업그레이드
pip install --upgrade openai

# 삭제
pip uninstall openai

# 설치된 패키지 목록
pip list

# 특정 패키지 정보
pip show openai

# 프로젝트 폴더 이동
mkdir my_project && cd my_project

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

# 가상환경 활성화
# macOS/Linux:
source venv/bin/activate

# Windows:
venv\Scripts\activate

# 활성화 확인 (프롬프트 앞에 (venv) 표시)
(venv) $ python --version

# 가상환경 비활성화
deactivate

# 현재 설치된 패키지를 파일로 저장
pip freeze > requirements.txt

# 파일에서 패키지 일괄 설치 (다른 환경 세팅 시)
pip install -r requirements.txt

openai==1.12.0
langchain==0.1.9
langchain-openai==0.0.8
chromadb==0.4.22
fastapi==0.109.2
uvicorn==0.27.1
python-dotenv==1.0.1
pydantic==2.6.1

# .gitignore
venv/
.env
__pycache__/
*.pyc
.DS_Store
*.log

my_llm_project/
├── venv/               # ← .gitignore에 추가
├── .env                # ← .gitignore에 추가
├── .gitignore
├── requirements.txt
├── README.md
├── main.py
├── config.py           # 설정값 모음
└── utils/
    ├── __init__.py
    └── helpers.py

# .env 파일
OPENAI_API_KEY=sk-proj-...
TAVILY_API_KEY=tvly-...
DATABASE_URL=postgresql://localhost/mydb
DEBUG=true

# config.py
from dotenv import load_dotenv
import os

load_dotenv()  # .env 파일 로드

OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
TAVILY_API_KEY = os.getenv("TAVILY_API_KEY")
DEBUG = os.getenv("DEBUG", "false").lower() == "true"

if not OPENAI_API_KEY:
    raise ValueError("OPENAI_API_KEY가 설정되지 않았습니다.")

# 1. 폴더 생성
mkdir my_project && cd my_project

# 2. 가상환경 생성·활성화
python -m venv venv
source venv/bin/activate  # (또는 Windows: venv\Scripts\activate)

# 3. 필요 패키지 설치
pip install openai python-dotenv

# 4. 설정 파일 생성
touch .env .gitignore requirements.txt

# 5. .gitignore 작성
echo "venv/\n.env\n__pycache__/" > .gitignore

# 6. 의존성 저장
pip freeze > requirements.txt

# 7. 코딩 시작!

[project]
name = "my-llm-project"
version = "0.1.0"
requires-python = ">=3.11"
dependencies = [
    "openai>=1.10.0",
    "langchain>=0.1.9",
    "python-dotenv>=1.0.0",
]

# uv: 빠른 파이썬 패키지 관리자 (pip 대체)
pip install uv

uv init my_project
uv add openai langchain
uv run python main.py