StarTrail-org/LEANN

这是什么？

核心功能

• 01按需重算嵌入，显著降低索引存储占用。
• 02通过 Python API 和命令行构建与检索索引。
• 03支持 PDF、文本和 Markdown 文件，以及邮件、Chrome 历史、微信、iMessage 等个人数据。
• 04通过 MCP 服务接入 Slack、Twitter 书签等实时数据。
• 05兼容 Ollama 等本地大模型引擎及任何 OpenAI 兼容接口。

适用场景

• 在笔记本上检索多年积累的文档、邮件或聊天记录，无需上传数据。
• 通过 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 是什么？

本地向量索引与 RAG 工具，通过按需重算向量将存储占用降低约 97%，可在笔记本上检索个人数据。 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