BioPlayground

🧬
← AI Tools
ragintermediate

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)을 최소한의 디스크 소모로 구현할 수 있습니다.

💻 필요한 컴퓨터 사양

🧠RAM

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
📄 공식문서🐙 GitHub

📝 업데이트 노트

  1. vv0.3.77/19/2026

    LEANN v0.3.7 버전이 드디어 PyPI에 정식 출시되었습니다. 이제 `pip` 명령어를 통해 복잡한 설정 없이도 연구 환경에 아주 간편하게 설치할 수 있어요. 라이브러리 관리의 번거로움이 줄어든 만큼, 생명공학 데이터 분석 파이프라인을 더욱 빠르고 효율적으로 구축해 보세요.

🧪 관련 생명의 코드

관련된 생명의 코드 글이 아직 없습니다.