Skip to main content
인덱싱, 검색, 재순위화, 평가까지 포함한 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 공통 확인:
macOS/Ubuntu에서 faiss 확인:

기본 사용 예시

문서 로드부터 벡터 검색, 답변 생성까지의 기본 RAG 파이프라인입니다.
OPENAI_API_KEY 환경변수를 설정해야 OpenAI 임베딩과 LLM을 사용할 수 있습니다. 로컬 임베딩만 사용하려면 sentence-transformers로 대체합니다.

트러블슈팅

설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: agent-dev

다음 설치 단계를 이어서 진행합니다.