lucasastorian/llmwiki

Open Source Implementation of Karpathy's LLM Wiki. Upload documents, connect your Claude account via MCP, and have it write your wiki !

LLM Wiki – AIが維持する個人ナレッジベース

概要 – LLM Wiki は、既に読んでいるファイル(PDF、Word文書、スライド、ノート、Webクリップなど)を、検索可能で相互リンクされた「個人Wikipedia」に変えるセルフホスティングツールです。重い作業はAnthropicのClaudeモデルが行い、MCPプロトコルを介して接続します。毎晩のClaudeルーチンが、追加された新しい資料を読み取り、テキストを抽出し、Markdownページを更新または作成して、手動で編集することなくWikiを最新の状態に保ちます。

主要コンポーネント

  • CLI(./llmwiki …)は、既存ドキュメントのフォルダをインデックス化し、ローカルAPIサーバーとNext.js Web UIを起動し、Markdownページのwiki/フォルダを生成します。
  • Chrome拡張機能は、WebページやPDFをクリップし、セクションをハイライトし、コメントを追加できます。保存されたデータは同じワークスペースに配置され、Claudeが取り込めるようになります。
  • MCPサーバーは、ワークスペースをClaude(Claude Desktop、Claude Code、またはClaude Cowork)に公開します。Claudeは、小さなツールセット(search、read、create、edit、append、delete、lintなど)を使用してソースを読み取り、Markdownページを作成できます。
  • バックエンド抽象化 – ローカルではデータはファイルシステム上にSQLiteインデックスとともに保存されます。同じコードがPostgres + S3を使用したホストモードで実行できるため、Claudeツールは同じように動作します。
  • グラフビューアと視覚化 – Web UIは概念がどのようにリンクしているかを表示し、Mermaid図やチャートなどをレンダリングできます。

使用方法

  1. インストール – Python 3.11+、Node 20+、Officeファイル用のオプションのLibreOffice。リポジトリをクローンし、仮想環境を作成し、Python依存関係(api/requirements.txt、mcp/requirements.txt)とweb/のnpm依存関係をインストールします。
  2. フォルダを指定 – すべての研究ファイルを含むフォルダを指定します。CLIは隠し.llmwiki/インデックスと生成ページ用のwiki/フォルダを作成しますが、元のファイルを移動またはアップロードすることはありません。
  3. サービスを起動(./llmwiki open <folder>)。API、MCPサーバー、Web UIがhttp://localhost:3000で利用可能になります。
  4. Claudeを接続 – ./llmwiki mcp-config <folder>を実行し、出力されたJSONをClaudeの設定ファイルに貼り付けます。次にClaudeに「ソースを取り込んでWikiの構築を開始してください」と指示します。
  5. ルーチンをスケジュール – 次のようなプロンプトで毎晩実行されるClaude Routine(またはローカルのスケジュールタスク)を作成します:

    「ガイドを読んでください。前回の実行以降に追加されたすべてのものを見つけてWikiを更新し、新しいページを作成するか、既存のページに資料を統合し、引用と相互参照を修正してください。」 ルーチンは自動的にWikiを最新の状態に保ちます。

  6. コンテンツを追加 – Web UIにファイルをドラッグ&ドロップするか、ワークスペースフォルダに直接ドロップするか、Chrome拡張機能を使用してWebコンテンツをクリップして注釈を付けます。

サポートされるソースタイプ – PDF(オプションのMistral OCR)、Word/PowerPoint(LibreOffice変換経由)、Excelシート、HTMLページ(Markdownに変換)、プレーンテキストファイル(.md、.txt、.csv、.jsonなど)、および画像(インラインで保存され、要求時にClaudeが読み取れます)。

得られるもの

  • wiki/の下のMarkdownページのセット。手動で編集、バージョン管理、またはClaudeに変更させることができます。
  • 全文検索と引用グラフクエリを強化する検索可能なインデックス(.llmwiki/index.db)。
  • ページ間の相互リンクと元のソースへのリンク、および視覚的なグラフと図のサポート。

ロードマップのハイライト – Slack、会議メモサービス(Granola)、メール転送からの取り込み、Webhook付きの公開取り込みAPI、および既に使用しているツールからコンテンツをキャプチャするためのZapier統合を追加。

ライセンス – Apache 2.0。


結論 – LLM Wiki は、Andrej Karpathyが広めた「AIが維持する個人Wiki」のアイデアの具体的なオープンソース実装です。シンプルなローカルワークフロー(フォルダベースのストレージ+ SQLite)とClaude駆動の自律更新、Chromeクリッピング拡張機能、モダンなNext.js UIを組み合わせており、読書や研究に合わせて自動的に成長するセカンドブレインを構築する実用的な方法です。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト