Repolode
StarTrail-org

StarTrail-org/LEANN

オンデマンドで埋め込みを再計算し、ストレージを約97%削減するローカルベクトルインデックス兼RAGツールキット。ノートPC上の個人データを検索できます。

スター
13,043
フォーク
1,212
未解決の Issue
37
最終コミット
8 時間前

これは何?

LEANNは、個人用デバイスで動作する検索拡張生成(RAG)向けのベクトルデータベースです。すべての埋め込みを保存する代わりに、コンパクトなグラフインデックスを保持し、検索時に必要な埋め込みをオンデマンドで計算します。プロジェクトによると、精度を損なわずにストレージを約97%削減できます。ドキュメント、メール、ブラウザー履歴、チャットログなど、大量の個人データをローカルで実用的にインデックス化することを目指しています。

PyPIからインストールできるPythonパッケージを提供しており、インデックスの作成や検索、検索結果をもとにしたLLMとのチャットを宣言的なAPIで実行できます。PDFやテキストファイル、Apple Mail、Chromeの履歴、WeChat、iMessage、ChatGPTやClaudeのチャットエクスポート用のサンプルアプリが含まれています。また、SlackやTwitterのブックマークなどのライブソースに接続するMCPサーバーも備えています。Claude Codeのセマンティック検索サービスとしても利用できます。

生成と埋め込みには、Ollama、LM Studio、vLLM、llama.cppなどのローカルエンジンに加え、複数のクラウドプロバイダーを含むOpenAI互換エンドポイントを利用できます。インデックスの構築と検索はUbuntu、Arch、WSL、macOS、Windowsで動作し、バックエンドにはDiskANNとHNSWを選べます。

主な機能

  • 01埋め込みをオンデマンドで再計算し、インデックスのストレージ容量を大幅に削減します。
  • 02Python APIとCLIからインデックスを構築・検索できます。
  • 03PDF、テキスト、Markdownファイルのほか、Apple Mail、Chromeの履歴、WeChat、iMessageのデータをインデックス化できます。
  • 04MCPサーバーを通じて、SlackやTwitterのブックマークなどのライブソースに接続できます。
  • 05OllamaなどのローカルLLMエンジンや、任意のOpenAI互換APIで動作します。

ユースケース

  • データをアップロードせずに、ノートPC上で何年分もの個人ドキュメント、メール、チャット履歴を検索する。
  • 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 とは?
オンデマンドで埋め込みを再計算し、ストレージを約97%削減するローカルベクトルインデックス兼RAGツールキット。ノートPC上の個人データを検索できます。 LEANNは、個人用デバイスで動作する検索拡張生成(RAG)向けのベクトルデータベースです。すべての埋め込みを保存する代わりに、コンパクトなグラフインデックスを保持し、検索時に必要な埋め込みをオンデマンドで計算します。プロジェクトによると、精度を損なわずにストレージを約97%削減できます。ドキュメント、メール、ブラウザー履歴、チャットログなど、大量の個人データをローカルで実用的にインデックス化することを目指しています。
LEANN は無料で使えますか?ライセンスは?
LEANN は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
LEANN は今もメンテナンスされていますか?
活発にメンテナンス中。LEANN の最終コミットは 2026年10月21日 です。
LEANN は何に使えますか?
データをアップロードせずに、ノートPC上で何年分もの個人ドキュメント、メール、チャット履歴を検索する。 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

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト