FootprintAI/Containarium

Containarium – AI エージェント向けオープンソースランタイム

概要 – 各 AI エージェントに SSH で到達可能な専用の隔離 Linux コンテナ（LXC または Kubernetes）を提供するセルフホスト型プラットフォームです。コンテナ内では軽量な MCP（メッセージ制御プロトコル）サーバー（agent-box）が実行され、エージェントは shell_exec、read_file、write_file などの安全で制限付きのコマンドを発行できます。ホスト側でも MCP サーバーが実行され、コンテナの作成、一覧表示、削除、公開を行います。すべての通信は JWT 認証され、「センチネル」VM をフロントに置くことで TLS を終端し、SSH/HTTPS を適切なバックエンドボックスにルーティングできます。

重要性 – AI エージェント（Claude、Cursor、Gemini、カスタム MCP クライアント）は、開発者のラップトップや共有 Kubernetes クラスタを汚染することなく、コードのコンパイル、依存関係のインストール、テストの実行、Web アプリの提供を行う場所を必要とします。Containarium は以下を提供します：

• 永続性 – コンテナはエージェントの実行間で存続します。
• 強力な分離 – 各テナントは独自のネットワーク名前空間を持ち、kube-apiserver トークンはなく、eBPF 出力ポリシーがあります。
• 本物の Linux 環境 – 完全な systemd、GPU パススルー、ZFS スナップショットなど。
• セルフホスト – SaaS 専用サンドボックスとは異なり、安価な Ubuntu VM、オンプレミスハードウェア、または任意のクラウドで実行できます。

コアコンポーネント

コンポーネント	役割
agent-box（コンテナ内 MCP サーバー）	コンテナ内で安全なファイルシステムおよびシェル操作を実行します。
プラットフォーム MCP サーバー	コンテナを管理します（作成、開始、停止、ポート公開、メトリクス）。
containarium CLI	プラットフォーム MCP と通信し、SSH 設定を生成するユーザー向けツール。
Sentinel（sshpiper + Caddy）	SSH と HTTPS を適切なバックエンドコンテナにルーティングし、公開ホスト名と TLS 終端を提供する常時稼働 VM。
セキュリティ層	JWT 認証、オプションのイメージダイジェスト検証、KMS によるエンベロープ暗号化シークレット、eBPF 出力ポリシー。

典型的なワークフロー

1. インストール Ubuntu VM にデーモンをインストールします（curl … | sudo bash）。
2. ボックスを作成: containarium quickstart alice – LXC コンテナを構築し、SSH キーを作成し、~/.containarium/ssh_config を書き込み、ボックスをエージェントの MCP 設定に配線します。
3. SSH で接続: ssh alice hostname。
4. ボックス内にエージェントをインストール: containarium code install alice（例: agent-box と Claude Code を配置）。
5. コードを実行: containarium code run alice --prompt "add a health endpoint" – エージェントはコンテナ内で実行され、ログはストリーミングされ、後で再アタッチできます。
6. サービスを公開: containarium expose-port alice --container-port 8080 --domain blog.example.com – センチネル上の Caddy がトラフィックをコンテナにルーティングします。

誰が使うか –

• 自社インフラストラクチャで自律コーディングエージェントを実行したいチーム。
• GPU 対応で永続的、かつ厳格な分離を備えたサンドボックスを必要とする企業。
• SSH でどこからでも到達可能で、公開 Web アプリを提供できる再現可能な環境を望む開発者。

開始方法 – README のクイックスタートセクションに従ってください: 新しい Ubuntu 24.04 VM で、インストーラーを実行し、containarium quickstart <name> を実行し、SSH 設定を同期し、エージェントをインストールします。リポジトリには、マルチプール展開、セキュリティ強化、統合（例: pi 開発環境）のドキュメントもあります。

ライセンスとコミュニティ – Apache 2.0、Go 1.25 コードベース、公開 MCP サーバーバッジ、ライブデモサイト。