Repolode
tjmlabs

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. 1

    GitHubリポジトリをクローンします

    git clone https://github.com/Jonathan-Adly/agentrun
  2. 2

    REST APIフォルダーに移動します

    cd agentrun/agentrun-api
  3. 3

    サンプルから環境設定ファイルを作成します

    cp .env.example .env.dev
  4. 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 の数値は毎日更新されます。

関連プロジェクト