alfredfrancis/ai-chatbot-framework

解決する課題

このプロジェクトは、プライベートなセルフホスト型AIアシスタント環境を提供します。個人のファイル、カスタムスキル、外部アプリケーションデータへのAIエージェントのアクセスを管理しつつ、やり取りを安全で隔離されたワークスペース内に収めるという課題を解決します。

仕組み

各ユーザーには、エージェントのサンドボックスとして機能するプライベートな Docker コンテナが割り当てられます。エージェントは、読み取り、書き込み、編集、bash コマンドの実行といった一連のコアツールを使用してワークスペースと対話します。エージェントは、読み取りおよび更新が可能なプレーンテキストファイル（context.md および memory.md）を通じて、独自のメモリとコンテキストを管理します。カスタムスキルをアップロードしたり、安全な認証のために OAuth をサポートする Model Context Protocol (MCP) を介して外部サービスを接続したりすることで、エージェントの機能を拡張できます。

対象ユーザー

自身のファイルやツールに永続的にアクセスできるパーソナルAIアシスタントを求める個人、および他のアプリやエディタとの統合のために Agent Client Protocol (ACP) をサポートするエージェント環境をセルフホストしたい開発者に最適です。

ハイライト

• プライベートサンドボックス： すべてのユーザーに、エージェント、ファイル、ツール専用の隔離された Docker コンテナが提供されます。
• 柔軟なモデルサポート： Claude、OpenAI、および Ollama を介したローカルモデルなど、LangChain 互換のあらゆるプロバイダーで動作します。
• ファイルベースのメモリ： エージェントのメモリとユーザーコンテキストにシンプルな Markdown ファイルを使用しているため、エージェントが何を把握しているかを簡単に確認・編集できます。
• MCP 統合： Claude スタイルの MCP サーバーをサポートしており、GitHub、Linear、Notion などのアプリと接続可能です。
• ステアリング： エージェントが作業中にメッセージを送信でき、エージェントはそれを現在のタスクに組み込みます。
• 外部アクセス： ACP 準拠の WebSocket API を公開しており、外部のエディタやアプリケーションがエージェントと対話できます。