인덱싱, 검색, 재순위화, 평가까지 포함한 RAG 개발 환경입니다.
문서 기준
- 기준일:
2026-02-23 - Python:
3.12 - 운영체제: macOS, Ubuntu, Windows
- 동기화 명령:
uv sync
호환성 메모
faiss-cpu는 Windows에서 빌드 이슈가 있어 환경 마커로 제외됩니다. Windows 사용자는 ChromaDB, Qdrant, Milvus 등 다른 벡터 스토어를 사용합니다.RAG 파이프라인에서 패키지 역할
pyproject.toml
설치
1
프로젝트 생성
2
의존성 락 및 동기화
3
Jupyter 커널 등록
설치 확인
모든 OS 공통 확인:faiss 확인:
기본 사용 예시
문서 로드부터 벡터 검색, 답변 생성까지의 기본 RAG 파이프라인입니다.트러블슈팅
설치 점검 목록
- 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
- 설치 후 버전 확인 명령어(
--version)를 실행해 정상 설치를 검증했습니다. - PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
- 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.
관련 문서
Setup 홈
운영체제별 설치 흐름을 다시 확인합니다.
다음: agent-dev
다음 설치 단계를 이어서 진행합니다.

