swarmclawai/swarmvault

The local-first LLM Wiki: open-source knowledge graph builder, RAG knowledge base, and agent memory store. Built on Andrej Karpathy's pattern. An Obsidian alternative for personal knowledge management, AI second brain, and durable Claude Code / Codex / OpenClaw memory.

What it solves

SwarmVaultは、ドキュメント、コード、文字起こし、URLなどの断片化された情報を、構造化された永続的なMarkdown wikiとマシンリーダブルな知識グラフに整理する方法を提供します。情報の「知識の散逸」という問題を解決し、ソース間の接続を自動的に維持することで、パーソナル知識ベースやAIエージェント用のRAG (Retrieval-Augmented Generation) システムを構築するための手動作業を回避できます。

How it works

SwarmVaultは、データを管理するために3層アーキテクチャを採用しています：

  1. Raw sources: オリジナルのドキュメント（書籍、コードなど）の不変のコピーが raw/ ディレクトリに保存されます。
  2. The wiki: LLMによって生成され、人間が作成したMarkdownページ（要約、エンティティページ、相互参照）が wiki/ ディレクトリに保存されます。
  3. The schema: swarmvault.schema.md ファイルが、LLMがwikiを整理する際に従う構造と規約を定義します。

ユーザーはCLIを通じてデータをインジェスト（取り込み）し、情報をグラフとしてコンパイルします。システムはハイブリッド検索（SQLite full-text searchとセマンティック埋め込みの組み合わせ）をサポートし、ナビゲーション用のグラフビューアを提供します。ヒューリスティック・プロバイダーを使用した完全オフライン動作、またはOllamaを使用したローカルLLM、あるいはクラウドAPIへの接続も可能です。

Who it’s for

  • Researchers and students 深い研究や書籍のコンパニオン作成を行う人々。
  • Developers コードドキュメントの構築やプロジェクト知識の管理を行う人々。
  • Knowledge workers ビジネスインテリジェンスや個人知識管理を行う人々。
  • AI Agent developers MCPサーバーやコンテキストパックを通じてエージェントにコンテキストを提供するために、構造化されたグラフベースの知識ベースを必要とする人々。

Highlights

  • Local-first & Offline: 内蔵のヒューリスティック・プロバイダーまたはローカルLLM（例：Ollama）を使用し、APIキーなしで動作します。
  • Graph-based Navigation: インタラクティブなグラフビューアと、パスをクエリし関係性を説明するコマンドが含まれています。
  • Hallucination Control: エッジを extracted, inferred, または ambiguous としてタグ付けし、自動的な矛盾検知を含みます。
  • Agent Integration: フックとMCPサーバーを介して、様々なAIエージェント（Claude, Cursor, Copilot, etc.）をサポートします。
  • Multi-format Ingest: GitHub repos、YouTube文字起こし、Whisperによるローカルオーディオファイルなど、30以上の入力形式を扱えます。