会話履歴をそのまま保存し、セマンティック検索で取得するローカルファーストのAIメモリシステム。MCPサーバーとCLIを提供します。
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
README に記載されている公式インストールスクリプトを使って uv(パッケージマネージャー)をインストールする
- 2
uv で仮想環境を作成する
uv venv - 3
仮想環境を有効化する
source .venv/bin/activate - 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 の数値は毎日更新されます。
関連プロジェクト
AIアプリ向けのオープンソース埋め込みデータベース。文書とベクトルを保存し、セマンティック検索、ハイブリッド検索、全文検索を実現します。
WebページやPDFをスクリーンショット化して画像検索し、表やグラフを保持したままRAGに活用できるオープンソースパイプライン。
RAG、ベクトル検索、エージェント、評価、監視を使ったLLMアプリケーション構築を学ぶ、無料のオープンソース10週間オンラインコース。
チャット履歴を再生するだけでなく、記憶を保存・想起・振り返ることで、AIエージェントが時間とともに学習できるようにするメモリシステムです。
LLMエージェントの会話や実行内容を、PythonおよびTypeScriptアプリ向けの永続的で構造化されたメモリに変換する、エージェントネイティブなメモリ基盤です。