Palace-AI – AIエージェントのための記憶の宮殿
Palace-AI は、コードベースを走査可能な「記憶の宮殿」に変換するオープンソースツールです。AIエージェントが検索ではなく関連付けでコードをナビゲートできるようにします。デフォルトではAST解析(APIキー不要)を使用し、オプションでLLMによる拡張が可能で、中〜大規模リポジトリではトークン消費を10〜42倍削減します。
Palace-AI は、AIエージェントがコードベースと対話する方法を変革する革新的なオープンソースツールです。コードベースを「記憶の宮殿」に変換することで、エージェントは従来の検索ではなく関連付けによってコードを理解しナビゲートできるようになります。これは人間の記憶の仕組みを模倣しており、効率を大幅に向上させます。
このプロジェクトはRhyChawによって作成され、Pythonで実装され、GitHubで公開されています。Palace-AIの核となるアイデアは、ソースコードを読む前に、「部屋」と「型付き関係」からなる構造図を構築し、エージェントが必要な情報を素早く特定できるようにすることです。
主要機能
Palace-AI は以下の主要機能を提供します:
- 記憶の宮殿の構築:
palace build .コマンドで、現在のコードベースをスキャンし、PALACE.mdマップと複数の部屋ファイルを生成します。各部屋ファイルには構造、エクスポート、呼び出しヒントが含まれます。 - 関連ノードのクエリ:
palace query "your topic"でトピックに関連するノードを検索できます。 - トークン節約の統計:
palace statsで従来の全文読み取りと比較したトークン節約効果を確認できます。通常10〜42倍の削減が見込めます。 - グラフ可視化:
palace serveでグラフ可視化ツールを起動できます。 - Claude Code統合:
palace install claudeでClaude Codeフックをインストールし、CLAUDE.mdとPreToolUseフックを自動生成します。
クイックスタート
インストールは簡単です:
pip install palace-ai
palace build .
palace query "your topic"
palace serve # オプション:グラフ可視化デフォルトでは、Palace-AI はAST解析のみを使用し、APIキーは不要です。よりリッチな部屋の要約が必要な場合は、--llm オプションを使用し、ANTHROPIC_API_KEY 環境変数を設定します。
動作原理
従来の方法では数千トークンのソースコードを直接コンテキストに入れていましたが、Palace-AI ではエージェントがまずマップファイルを読み、必要な部屋ファイルにアクセスし、最後に実際に必要なソースファイルを開きます。この階層的なナビゲーションにより、特に大規模なコードベースでトークン消費が大幅に削減されます。
ライセンス
このプロジェクトはMITライセンスの下で提供され、完全にオープンソースです。
プロジェクトの状態
現在Palace-AIは初期段階ですが、完全な機能を備えています。GitHubリポジトリにはサンプル(requestsライブラリの事前構築された宮殿など)、テストフィクスチャ、詳細なドキュメントが含まれています。コミュニティのコントリビューターはGitHubを通じて改善に参加できます。