LEANN
LEANN은 UC Berkeley의 Sky Computing Lab 연구진이 주도하는 StarTrail-org에서 개발한 초경량 온디바이스(On-device) RAG(Retrieval-Augmented Generation) 전용 벡터 인덱싱 기술입니다. 기존의 벡터 데이터베이스가 수많은 문서 청크의 고차원 밀집 벡터(Dense vector)를 디스크에 영구 저장함으로써 원본 데이터보다 더 큰 저장 공간을 요구했던 문제를 해결하기 위해, LEANN은 그래프 구조만 유지하고 임베딩 자체는 검색 시점에만 실시간으로 '선택적 재연산(S
LEANN은 UC Berkeley의 Sky Computing Lab 연구진이 주도하는 StarTrail-org에서 개발한 초경량 온디바이스(On-device) RAG(Retrieval-Augmented Generation) 전용 벡터 인덱싱 기술입니다. 기존의 벡터 데이터베이스가 수많은 문서 청크의 고차원 밀집 벡터(Dense vector)를 디스크에 영구 저장함으로써 원본 데이터보다 더 큰 저장 공간을 요구했던 문제를 해결하기 위해, LEANN은 그래프 구조만 유지하고 임베딩 자체는 검색 시점에만 실시간으로 '선택적 재연산(Selective Recomputation)'하는 아키텍처를 도입했습니다.
핵심 동작 방식은 마치 지도 앱이 전 세계 모든 골목길의 3D 위성 사진을 디스크에 보관하는 대신 주요 도로망의 뼈대(그래프)만 기억하고 있다가, 사용자가 특정 경로를 탐색할 때 필요한 구간만 실시간으로 렌더링하는 것과 유사합니다. LEANN은 근접 그래프에서 탐색 허브 역할을 하는 주요 노드들을 보존하는 '높은 중요도 노드 중심 프루닝(High-degree Preserving Pruning)'을 적용하여 그래프 자체의 엣지를 대폭 정리하고, 이를 CSR(Compressed Sparse Row) 포맷으로 압축해 저장 공간을 최대 97%까지 획기적으로 줄입니다.
이러한 효율성은 개인정보 보호가 최우선이거나 네트워크 연결이 제한된 오프라인 환경의 노트북 등 개인용 하드웨어에서도 수백만 개의 문서를 대상으로 고성능 RAG를 실행할 수 있게 해줍니다. 그래프 순회 중에 필요한 노드들만 동적 배치(Dynamic Batching)를 통해 하드웨어 가속기에서 순간적으로 임베딩을 재계산하므로, 외부 서버에 데이터를 전송하지 않는 100% 프라이빗 시맨틱 검색(Semantic Search)을 최소한의 디스크 소모로 구현할 수 있습니다.
💻 필요한 컴퓨터 사양
0 (CPU 단독으로 작동 가능하나, 임베딩 실시간 재연산 성능 향상을 위해 NVIDIA GPU 4GB+ 또는 Apple Silicon 통합 메모리 권장)
모델 및 데이터 용량에 따라 다르나, 인덱스 파일 크기는 기존 벡터 DB 대비 97% 감소(수백만 개 청크 기준 수십 MB~수백 MB 수준)
⚡ 설치법
4-1. Quick Start
uv tool install leann-core --with leann
4-2. 상세 설치
GitHub 저장소 복제 및 이동git clone https://github.com/StarTrail-org/LEANN.git cd LEANN
uv를 사용한 가상환경 생성 및 활성화uv venv source .venv/bin/activate
leann 패키지 및 종속성 설치 (CPU 전용 환경은 leann[cpu] 권장)uv pip install leann
FAQ
LEANN은(는) 무엇인가요?
LEANN은 UC Berkeley의 Sky Computing Lab 연구진이 주도하는 StarTrail-org에서 개발한 초경량 온디바이스(On-device) RAG(Retrieval-Augmented Generation) 전용 벡터 인덱싱 기술입니다. 기존의 벡터 데이터베이스가 수많은 문서 청크의 고차원 밀집 벡터(Dense vector)를 디스크에 영구 저장함으로써 원본 데이터보다 더 큰 저장 공간을 요구했던 문제를 해결하기 위해, LEANN은 그래프 구조만 유지하고 임베딩 자체는 검색 시점에만 실시간으로 '선택적 재연산(Selective Recomputation)'하는 아키텍처를 도입했습니다. 핵심 동작 방식은 마치 지도 앱이 전 세계 모든 골목길의 3D 위성 사진을 디스크에 보관하는 대신 주요 도로망의 뼈대(그래프)만 기억하고 있다가, 사용자가 특정 경로를 탐색할 때 필요한 구간만 실시간으로 렌더링하는 것과 유사합니다. LEANN은 근접 그래프에서 탐색 허브 역할을 하는 주요 노드들을 보존하는 '높은 중요도 노드 중심 프루닝(High-degree Preserving Pruning)'을 적용하여 그래프 자체의 엣지를 대폭 정리하고, 이를 CSR(Compressed Sparse Row) 포맷으로 압축해 저장 공간을 최대 97%까지 획기적으로 줄입니다. 이러한 효율성은 개인정보 보호가 최우선이거나 네트워크 연결이 제한된 오프라인 환경의 노트북 등 개인용 하드웨어에서도 수백만 개의 문서를 대상으로 고성능 RAG를 실행할 수 있게 해줍니다. 그래프 순회 중에 필요한 노드들만 동적 배치(Dynamic Batching)를 통해 하드웨어 가속기에서 순간적으로 임베딩을 재계산하므로, 외부 서버에 데이터를 전송하지 않는 100% 프라이빗 시맨틱 검색(Semantic Search)을 최소한의 디스크 소모로 구현할 수 있습니다.
LEANN은(는) 언제 사용하나요?
LEANN은 UC Berkeley의 Sky Computing Lab 연구진이 주도하는 StarTrail-org에서 개발한 초경량 온디바이스(On-device) RAG(Retrieval-Augmented Generation) 전용 벡터 인덱싱 기술입니다. 기존의 벡터 데이터베이스가 수많은 문서 청크의 고차원 밀집 벡터(Dense vector)를 디스크에 영구 저장함으로써 원본 데이터보다 더 큰 저장 공간을 요구했던 문제를 해결하기 위해, LEANN은 그래프 구조만 유지하고 임베딩 자체는 검색 시점에만 실시간으로 '선택적 재연산(S
📝 업데이트 노트
아직 업데이트 노트가 없습니다.
🧪 관련 생명의 코드
관련된 생명의 코드 글이 아직 없습니다.