StarTrail-org/LEANN

어떤 프로젝트인가요?

핵심 기능

• 01필요할 때 임베딩을 다시 계산해 인덱스 저장 공간을 크게 줄입니다.
• 02Python API와 CLI로 인덱스를 생성하고 검색합니다.
• 03PDF, 텍스트, Markdown 파일과 Apple Mail, Chrome 기록, WeChat, iMessage 데이터를 인덱싱합니다.
• 04MCP 서버를 통해 Slack과 Twitter 북마크 같은 실시간 소스에 연결합니다.
• 05Ollama 같은 로컬 LLM 엔진과 모든 OpenAI 호환 API를 지원합니다.

활용 사례

• 데이터를 업로드하지 않고 노트북에서 수년간 쌓인 개인 문서, 이메일 또는 채팅 기록을 검색합니다.
• MCP를 통해 Claude Code에 코드베이스 시맨틱 검색을 추가합니다.
• 기기 간에 옮길 수 있는 비공개 휴대용 지식 베이스를 구축합니다.
• 내보낸 ChatGPT 또는 Claude 대화를 대상으로 로컬 RAG 챗봇을 실행합니다.

빠른 시작

1. 1

   README의 공식 설치 스크립트를 사용해 uv(패키지 관리자)를 설치합니다

2. 2

   uv로 가상 환경을 만듭니다

   uv venv
3. 3

   가상 환경을 활성화합니다

   source .venv/bin/activate
4. 4

   PyPI에서 LEANN을 설치합니다

   uv pip install leann

사용 전 알아둘 점

• !선택 사항인 DiskANN 백엔드를 빌드하려면 Boost, protobuf, MKL과 같은 상당한 시스템 종속성이 필요합니다.
• !클라우드 LLM 및 임베딩 제공업체를 사용하려면 API 키가 필요하며, 완전히 로컬에서 사용하려면 직접 추론 엔진을 실행해야 합니다.

토픽

자주 묻는 질문

LEANN은(는) 무엇인가요?

필요할 때 임베딩을 다시 계산해 저장 공간을 약 97% 줄이는 로컬 벡터 인덱스 및 RAG 툴킷으로, 노트북에서 개인 데이터를 검색할 수 있습니다. LEANN은 개인 기기에서 실행되는 검색 증강 생성(RAG)용 벡터 데이터베이스입니다. 모든 임베딩을 저장하는 대신 간결한 그래프 인덱스를 유지하고 검색 중에 필요할 때 임베딩을 계산합니다. 프로젝트에 따르면 정확도 저하 없이 저장 공간을 약 97% 줄일 수 있습니다. 문서, 이메일, 브라우저 기록, 채팅 로그 등 대규모 개인 데이터를 로컬에서 실용적으로 인덱싱하는 것이 목표입니다.

LEANN은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

LEANN은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

LEANN은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. LEANN의 마지막 커밋은 2026년 10월 21일입니다.

LEANN은(는) 어디에 사용할 수 있나요?

데이터를 업로드하지 않고 노트북에서 수년간 쌓인 개인 문서, 이메일 또는 채팅 기록을 검색합니다. MCP를 통해 Claude Code에 코드베이스 시맨틱 검색을 추가합니다. 기기 간에 옮길 수 있는 비공개 휴대용 지식 베이스를 구축합니다. 내보낸 ChatGPT 또는 Claude 대화를 대상으로 로컬 RAG 챗봇을 실행합니다.

LEANN는 어떻게 설치하나요?

README의 공식 설치 스크립트를 사용해 uv(패키지 관리자)를 설치합니다 uv로 가상 환경을 만듭니다: uv venv 가상 환경을 활성화합니다: source .venv/bin/activate PyPI에서 LEANN을 설치합니다: uv pip install leann

LEANN은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/StarTrail-org/LEANN