agent-infra/sandbox

これは何？

主な機能

• 01VNC、Chrome DevTools Protocol、MCPツールを使ったブラウザー操作
• 021つのファイルシステムを共有するシェルターミナルとファイルの読み書き
• 03ブラウザー上でコーディングできるVSCode ServerとJupyterLabを内蔵
• 04ブラウザー、ファイル、シェル、ドキュメント変換用の設定済みMCPサーバー
• 05サンドボックス内でのPythonおよびNode.jsコードの実行
• 06APIとサービスのエンドポイントを保護するオプションのAPIキー認証

ユースケース

• AIエージェントにシェルコマンドやコードを安全に実行できる環境を提供する
• ダウンロードしたファイルを後続処理するブラウザータスクを自動化する
• 開発者向けの使い捨てクラウドIDEをコンテナでホストする
• browser-useやLangChainなどのエージェントフレームワークを、すぐに使えるツール環境に接続する

クイックスタート

1. 1

   APIキーを使ってサンドボックスコンテナを起動します（推奨）

   docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest
2. 2

   localhost:8080でドキュメントを開きます

3. 3

   Python SDKをインストールします（任意）

   pip install agent-sandbox

使う前に知っておきたいこと

• !Dockerが必要です。また、コンテナはseccomp unconfinedで実行されます。
• !セットアップ時に、サイズの大きいオールインワンコンテナイメージをプルする必要があります。

トピック

よくある質問

sandbox とは？

AIエージェントがブラウザー、シェル、ファイルシステム、VSCode Server、Jupyter、MCPを共有できるDockerサンドボックス AIO Sandboxは、ブラウザー、ターミナル、ファイルシステム、VSCode Server、Jupyter、MCPサービスを1つのDockerコンテナにまとめます。エージェントや開発者は、同じ環境内でシェルコマンドの実行、ファイルの読み書き、ブラウザーの操作、PythonやNode.jsコードの実行ができます。そのため、ブラウザーでダウンロードしたファイルをすぐにシェルやファイル操作で利用できます。

sandbox は無料で使えますか？ライセンスは？

sandbox は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

sandbox は今もメンテナンスされていますか？

半年以内に更新あり。sandbox の最終コミットは 2026年9月14日 です。

sandbox は何に使えますか？

AIエージェントにシェルコマンドやコードを安全に実行できる環境を提供する ダウンロードしたファイルを後続処理するブラウザータスクを自動化する 開発者向けの使い捨てクラウドIDEをコンテナでホストする browser-useやLangChainなどのエージェントフレームワークを、すぐに使えるツール環境に接続する

sandbox のインストール方法は？

APIキーを使ってサンドボックスコンテナを起動します（推奨）: docker run --security-opt seccomp=unconfined --rm -it -e SANDBOX_API_KEY=your-secret-key -p 127.0.0.1:8080:8080 ghcr.io/agent-infra/sandbox:latest localhost:8080でドキュメントを開きます Python SDKをインストールします（任意）: pip install agent-sandbox

sandbox はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/agent-infra/sandbox