Repolode
StarTrail-org

StarTrail-org/LEANN

Локальный векторный индекс и инструментарий для RAG: пересчитывает эмбеддинги по запросу и сокращает объём хранения примерно на 97%, позволяя искать личные данные на ноутбуке.

Звёзды
13,043
Форки
1,212
Открытые issues
37
Последний коммит
7 часов назад

Что это?

LEANN — векторная база данных для генерации с дополнением извлечённой информацией (RAG), которая работает на персональном устройстве. Вместо хранения всех эмбеддингов она сохраняет компактный графовый индекс и вычисляет эмбеддинги по запросу во время поиска. По заявлению проекта, это сокращает объём хранилища примерно на 97% без потери точности. Цель проекта — упростить локальную индексацию больших личных коллекций: документов, писем, истории браузера и переписок.

Проект предоставляет Python-пакет, который можно установить из PyPI, с декларативным API для создания индекса, поиска по нему и общения с LLM на основе результатов. В комплект входят примеры приложений для работы с PDF и текстовыми файлами, Apple Mail, историей Chrome, WeChat, iMessage, а также экспортами переписок из ChatGPT и Claude. Кроме того, есть MCP-сервер для подключения источников с актуальными данными, например Slack и закладок Twitter. LEANN также работает с Claude Code как сервис семантического поиска.

Для генерации и создания эмбеддингов LEANN поддерживает локальные движки, например Ollama, LM Studio, vLLM и llama.cpp, а также любые совместимые с OpenAI конечные точки, в том числе несколько облачных провайдеров. Сборка и поиск работают в Ubuntu, Arch, WSL, macOS и Windows; доступны бэкенды DiskANN и HNSW.

Ключевые возможности

  • 01Пересчитывает эмбеддинги по запросу, существенно сокращая объём места, необходимого для индекса.
  • 02Создаёт индексы и выполняет поиск через Python API и CLI.
  • 03Индексирует PDF-, текстовые и Markdown-файлы, а также данные Apple Mail, истории Chrome, WeChat и iMessage.
  • 04Подключается к источникам с актуальными данными, например Slack и закладкам Twitter, через MCP-серверы.
  • 05Работает с локальными движками LLM, например Ollama, и любым API, совместимым с OpenAI.

Сценарии использования

  • Поиск по личным документам, почте и истории переписок за несколько лет на ноутбуке без загрузки данных в сеть.
  • Добавление семантического поиска по кодовой базе в Claude Code через MCP.
  • Создание приватной переносимой базы знаний, которую можно перемещать между устройствами.
  • Запуск локального RAG-чат-бота для работы с экспортами переписок из ChatGPT или Claude.

Быстрый старт

  1. 1

    Установите uv (менеджер пакетов) с помощью официального скрипта установки из README

  2. 2

    Создайте виртуальное окружение с помощью uv

    uv venv
  3. 3

    Активируйте виртуальное окружение

    source .venv/bin/activate
  4. 4

    Установите LEANN из PyPI

    uv pip install leann

Что важно знать

  • Для сборки дополнительного бэкенда DiskANN требуются значительные системные зависимости, такие как Boost, protobuf и MKL.
  • Для облачных провайдеров LLM и эмбеддингов требуется ключ API, а для полностью локального использования необходимо самостоятельно запустить движок инференса.

Темы

Частые вопросы

Что такое LEANN?
Локальный векторный индекс и инструментарий для RAG: пересчитывает эмбеддинги по запросу и сокращает объём хранения примерно на 97%, позволяя искать личные данные на ноутбуке. LEANN — векторная база данных для генерации с дополнением извлечённой информацией (RAG), которая работает на персональном устройстве. Вместо хранения всех эмбеддингов она сохраняет компактный графовый индекс и вычисляет эмбеддинги по запросу во время поиска. По заявлению проекта, это сокращает объём хранилища примерно на 97% без потери точности. Цель проекта — упростить локальную индексацию больших личных коллекций: документов, писем, истории браузера и переписок.
LEANN можно использовать бесплатно? Какая у него лицензия?
LEANN распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
LEANN всё ещё поддерживается?
Активно поддерживается. Последний коммит в LEANN — 21 окт. 2026 г..
Для чего можно использовать LEANN?
Поиск по личным документам, почте и истории переписок за несколько лет на ноутбуке без загрузки данных в сеть. Добавление семантического поиска по кодовой базе в Claude Code через MCP. Создание приватной переносимой базы знаний, которую можно перемещать между устройствами. Запуск локального RAG-чат-бота для работы с экспортами переписок из ChatGPT или Claude.
Как установить LEANN?
Установите uv (менеджер пакетов) с помощью официального скрипта установки из README Создайте виртуальное окружение с помощью uv: uv venv Активируйте виртуальное окружение: source .venv/bin/activate Установите LEANN из PyPI: uv pip install leann
Где скачать LEANN?
Исходный код и инструкции по установке — на GitHub: https://github.com/StarTrail-org/LEANN

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты