Docker、Kubernetes、Podman、ローカルのLinuxやWindowsなど、複数のバックエンドでLLM生成コードを隔離環境内で実行するPythonライブラリ。
tjmlabs/AgentRun
LLMが生成したPythonコードを、リソース制限・タイムアウト・安全性チェック付きの隔離Dockerコンテナで実行するPythonライブラリ兼REST APIです。
代替できる製品:OpenAI Code Interpreter
- スター
- 383
- フォーク
- 39
- 未解決の Issue
- 9
- 最終コミット
- 15 日前
これは何?
AgentRunを使うと、大規模言語モデルが生成したPythonコードをアプリケーションからサンドボックス環境に渡し、例外やトレースバックを含む実行結果を取得できます。Docker Python SDKとRestrictedPythonをベースとしており、コードはホストシステム上ではなく、隔離されたDockerコンテナ内で実行されます。
実行前に、危険な要素がコードに含まれていないかチェックします。CPUクォータ、メモリとスワップの上限、実行タイムアウト(デフォルトは20秒)を設定でき、インストールを許可するpipパッケージをホワイトリストで指定できます。後続の実行を高速化するため、依存関係をあらかじめコンテナイメージにキャッシュすることもでき、生成コードが作成した成果物は自動的に削除されます。
利用方法は2通りあります。pipパッケージをインストールして、起動済みのDockerコンテナに接続する方法と、リポジトリをcloneして同梱のDocker Compose構成を起動する方法です。後者では、任意の言語から呼び出せるRESTエンドポイント /v1/run/ が公開されます。
主な機能
- 01実行前に生成コードの危険な操作をチェックします。
- 02隔離されたDockerコンテナ内でコードを実行します。
- 03CPU、メモリ、スワップ、タイムアウトの上限を設定できます。
- 04pipの依存関係をホワイトリストで管理し、事前にキャッシュできます。
- 05すぐに実行できるDocker Compose構成のREST APIが付属します。
- 06Pythonをローカルで実行した場合と同じ出力やトレースバックを返します。
ユースケース
- LLMエージェントにコードを実行させ、数学やデータに関する質問に回答させる。
- チャットボットやAIプロダクトにコードインタープリター機能を追加する。
- 社内ツール向けに、サンドボックス化されたコード実行サービスをセルフホストする。
クイックスタート
- 1
GitHubリポジトリをクローンします
git clone https://github.com/Jonathan-Adly/agentrun - 2
REST APIフォルダーに移動します
cd agentrun/agentrun-api - 3
サンプルから環境設定ファイルを作成します
cp .env.example .env.dev - 4
Dockerサービスをビルドして起動します
docker-compose up -d --build
使う前に知っておきたいこと
- Dockerがインストールされ、起動している必要があります。
- pipパッケージを使用するには、自分で起動したDockerコンテナを用意する必要があります。
収録されている特集
トピック
よくある質問
- AgentRun とは?
- LLMが生成したPythonコードを、リソース制限・タイムアウト・安全性チェック付きの隔離Dockerコンテナで実行するPythonライブラリ兼REST APIです。 AgentRunを使うと、大規模言語モデルが生成したPythonコードをアプリケーションからサンドボックス環境に渡し、例外やトレースバックを含む実行結果を取得できます。Docker Python SDKとRestrictedPythonをベースとしており、コードはホストシステム上ではなく、隔離されたDockerコンテナ内で実行されます。
- AgentRun は無料で使えますか?ライセンスは?
- AgentRun は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- AgentRun は今もメンテナンスされていますか?
- 活発にメンテナンス中。AgentRun の最終コミットは 2026年10月23日 です。
- AgentRun は何に使えますか?
- LLMエージェントにコードを実行させ、数学やデータに関する質問に回答させる。 チャットボットやAIプロダクトにコードインタープリター機能を追加する。 社内ツール向けに、サンドボックス化されたコード実行サービスをセルフホストする。
- AgentRun のインストール方法は?
- GitHubリポジトリをクローンします: git clone https://github.com/Jonathan-Adly/agentrun REST APIフォルダーに移動します: cd agentrun/agentrun-api サンプルから環境設定ファイルを作成します: cp .env.example .env.dev Dockerサービスをビルドして起動します: docker-compose up -d --build
- AgentRun はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/tjmlabs/AgentRun
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
AIエージェントのワークロードをハードウェア分離されたMicroVMで実行するオープンソースのサンドボックスサービス。E2B SDK互換で、起動は60ms未満。
HTTP APIで制御する、Firecracker microVM内でエージェントやユーザーのコードを隔離実行するサンドボックス基盤。
信頼できないコードを軽量なVMサンドボックスで実行する、CLI・HTTP API・Python SDKで操作可能なKubernetesベースのセルフホスト型基盤。
AIエージェントがコード、コマンド、ファイル、ブラウザーを実行できる、独自インフラ上のオープンソース・サンドボックスランタイム。
AIエージェントがブラウザー、シェル、ファイルシステム、VSCode Server、Jupyter、MCPを共有できるDockerサンドボックス