LEANN

(★ 12,821)

[MLsys2026]: LEANN을 활용한 RAG on Everything. 개인 기기에서 빠르고 정확하며 100% 프라이버시가 보장되는 RAG 애플리케이션을 실행하는 동시에 97%의 스토리지 절감 효과를 누리세요.

파일 탐색기

최종 버전 다운로드 (.zip)

- devcontainer.json
- - bug_report.yml
  - config.yml
  - feature_request.yml
- - build-and-publish.yml
  - build-reusable.yml
  - link-check.yml
  - release-manual.yml
- pull_request_template.md
- extensions.json
- settings.json
- - __init__.py
  - chatgpt_reader.py
- - __init__.py
- - __init__.py
  - claude_reader.py
- - email.py
  - LEANN_email_reader.py
- - __init__.py
  - gemini_reader.py
- - __init__.py
  - history.py
  - wechat_history.py
- - __init__.py
  - imessage_reader.py
- - __init__.py
  - qwen_reader.py
- - leann-plus-temporal-search.py
  - leann_index_builder.py
  - spotlight_index_dump.py
- - __init__.py
  - slack_mcp_reader.py
- - __init__.py
  - twitter_mcp_reader.py
- __init__.py
- base_rag_example.py
- browser_rag.py
- chatgpt_rag.py
- claude_rag.py
- code_rag.py
- colqwen_rag.py
- document_rag.py
- email_rag.py
- gemini_rag.py
- image_rag.py
- imessage_rag.py
- qwen_rag.py
- slack_rag.py
- twitter_rag.py
- wechat_rag.py
- arch.png
- claude_code_leann.png
- effects.png
- logo-text.png
- logo.png
- mcp_leann.png
- wechat_user_group.JPG
- - README.md
  - run_bm25.py
  - run_diskann.py
- - .gitignore
  - README.md
- - README.md
- - evaluate_enron_emails.py
  - README.md
  - setup_enron_emails.py
- - evaluate_financebench.py
  - README.md
  - setup_financebench.py
  - verify_recall.py
- - .gitignore
  - evaluate_laion.py
  - README.md
  - setup_laion.py
- - __init__.py
  - bench_hnsw_rng_recompute.py
  - bench_results.csv
  - bench_update_vs_offline_search.py
  - offline_vs_update.csv
  - plot_bench_results.py
  - README.md
- __init__.py
- benchmark_embeddings.py
- benchmark_no_recompute.py
- compare_faiss_vs_leann.py
- diskann_vs_hnsw_speed_comparison.py
- faiss_only.py
- flashlib_ivf_vs_faiss_ivf.py
- issue_159.py
- llm_utils.py
- micro_tpt.py
- README.md
- run_evaluation.py
- simple_mac_tpt_test.py
- 2501.14312v1 (1).pdf
- 2506.08276v1.pdf
- huawei_pangu.md
- PrideandPrejudice.txt
- Dockerfile
- Dockerfile.cpu
- Dockerfile.dev
- README.md
- - embedding_model_compare.py
- - smart-embedding-default.md
- - slack_integration_1.1.png
  - slack_integration_1.2.png
  - slack_integration_1.3.png
  - slack_integration_2.1.png
  - slack_integration_2.2.png
  - slack_integration_2.3.png
- ast_chunking_guide.md
- CHANGELOG.md
- COLQWEN_GUIDE.md
- configuration-guide.md
- CONTRIBUTING.md
- faq.md
- features.md
- flashlib_backend_guide.md
- grep_search.md
- metadata_filtering.md
- normalized_embeddings.md
- openclaw-setup.md
- react_agent.md
- RELEASE.md
- roadmap.md
- slack-setup-guide.md
- THINKING_BUDGET_FEATURE.md
- ultimate_goal.md
- user-scripts.md
- __init__.py
- basic_demo.py
- dynamic_update_no_recompute.py
- grep_search_example.py
- mcp_integration_demo.py
- mlx_demo.py
- spoiler_free_book_rag.py
- - __init__.py
  - pyproject.toml
  - README.md
- - __init__.py
  - CMakeLists.txt
  - pyproject.toml
- - pyproject.toml
  - README.md
- - pyproject.toml
  - README.md
- - CMakeLists.txt
  - pyproject.toml
- - pyproject.toml
  - README.md
- - pyproject.toml
  - README.md
- - README.md
- - __init__.py
  - main.py
  - wechattweak-cli
- __init__.py
- astchunk-leann
- build_and_test.sh
- bump_version.sh
- hf_upload.py
- release.sh
- upload_to_pypi.sh
- - claw.json
  - instructions.md
  - README.md
- leann-build.yaml
- - .gitignore
  - __init__.py
  - conftest.py
  - docker-compose.yml
  - run_docker_test.sh
  - test_build_and_search.py
  - test_mcp_e2e.py
  - test_mcp_protocol.py
  - test_openclaw_e2e.py
  - test_skill_manifest.py
- - fake_embedding_server_module.py
- README.md
- test_astchunk_integration.py
- test_atlascloud_provider.py
- test_basic.py
- test_build_from_arrays.py
- test_ci_minimal.py
- test_cli_ask.py
- test_cli_daemon_workflow.py
- test_cli_list_performance.py
- test_cli_prompt_template.py
- test_cli_verbosity.py
- test_cpu_only_install.py
- test_diskann_partition.py
- test_document_rag.py
- test_embedding_batch_size.py
- test_embedding_prompt_template.py
- test_embedding_server_cli_flags.py
- test_embedding_server_manager.py
- test_embedding_server_manager_e2e.py
- test_flashlib_ivf_backend.py
- test_hnsw_rebuild_fallback.py
- test_hybrid_search.py
- test_incremental_build.py
- test_litellm_provider.py
- test_lmstudio_bridge.py
- test_mcp_integration.py
- test_mcp_standalone.py
- test_metadata_filtering.py
- test_minimax_provider.py
- test_novita_provider.py
- test_passage_id_scheme.py
- test_prompt_template_e2e.py
- test_prompt_template_persistence.py
- test_react_dual_source.py
- test_readme_examples.py
- test_rebuild_cli.py
- test_sync.py
- test_token_truncation.py
- test_watch_sync_scope.py
- google_clear.gif
- mail_clear.gif
- paper_clear.gif
- wechat_clear.gif
.gitignore
.gitmodules
.pre-commit-config.yaml
.python-version
CLAUDE.md
demo.ipynb
LICENSE
llms.txt
pyproject.toml
README.md
uv.lock

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/StarTrail-org/LEANN

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd LEANN

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.
Chocolatey Windows용 패키지 매니저입니다.

curl -LsSf https://astral.sh/uv/install.sh | sh

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

brew install libomp boost protobuf zeromq pkgconf

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

choco install cmake swig pkgconfiglite nuget.commandline -y

Chocolatey로 바로 설치합니다 (Windows).

curl -fsSL https://ollama.ai/install.sh | sh

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Docker

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Docker Desktop 컨테이너를 빌드하고 실행하려면 필요합니다. 설치 후 실행해서 백그라운드에 켜두세요.

docker build -f docker/Dockerfile -t leann .

Dockerfile을 기반으로 실행 가능한 이미지를 빌드합니다.

docker run -p 8080:80 leann

빌드된 이미지를 실제 컨테이너로 실행합니다.

✅ 터미널에 docker compose ps 를 입력해 컨테이너들이 Up 상태인지 확인하세요. README에 포트 번호가 적혀있다면 브라우저에서 http://localhost:포트번호 로 접속해보세요.

4. CMake

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
CMake 빌드 설정을 생성하는 도구입니다.
C/C++ 컴파일러 Windows는 Visual Studio(Community 무료), macOS는 Xcode Command Line Tools, Linux는 gcc/g++ 패키지가 필요합니다.

sudo pacman -Syu && sudo pacman -S --needed base-devel cmake pkgconf git gcc \

이 명령어를 터미널에 그대로 입력해 실행하세요.

choco install cmake swig pkgconfiglite nuget.commandline -y

Chocolatey로 바로 설치합니다 (Windows).

✅ build 폴더 안에 실행 파일이 생성됐는지 확인하고, 직접 실행해보세요 (예: ./build/앱이름).

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

5. Python

쉬움

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Python 3 설치 시 'Add Python to PATH' 옵션을 꼭 체크하세요 (Windows).

uv pip install leann

requirements.txt 등에 명시된 파이썬 라이브러리를 설치합니다.

python -m apps.document_rag --query "What are the main techniques LEANN explores?"

파이썬 스크립트(또는 모듈)를 실행합니다.

python -m apps.document_rag --data-dir "~/Documents/Papers" --chunk-size 1024

파이썬 스크립트(또는 모듈)를 실행합니다.

python -m apps.document_rag --data-dir "./docs" --chunk-size 256 --file-types .md .py

파이썬 스크립트(또는 모듈)를 실행합니다.

python -m apps.document_rag --enable-code-chunking --data-dir "./my_project"

파이썬 스크립트(또는 모듈)를 실행합니다.

✅ 에러 메시지 없이 실행되고 터미널에 안내 문구가 출력되면 정상입니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

LEANN

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. CMake

5. Python

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

LEANN

파일 탐색기

# 설치 가이드

2. 공식 설치 스크립트

3. Docker

4. CMake

5. Python

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README