Repolode
提交项目
tjmlabs

tjmlabs/AgentRun

一个 Python 库和 REST API，在隔离的 Docker 容器中安全执行 LLM 生成的 Python 代码，并支持资源限制与超时控制。

可替代:OpenAI Code Interpreter

在 GitHub 查看
Star
383
Fork
39
未关闭 Issue
9
最近提交
15天前

这是什么？

AgentRun 让应用可以把大语言模型生成的 Python 代码交给隔离环境执行，并返回输出结果，包括异常和错误堆栈。它基于 Docker Python SDK 和 RestrictedPython 构建，代码运行在独立的 Docker 容器中，而不是宿主机上。

执行前会检查代码中的危险操作。开发者可以设置 CPU 配额、内存和 swap 上限以及执行超时（默认 20 秒），并通过白名单限制允许安装的 pip 依赖。依赖还可以预先缓存到容器镜像中以加快后续执行，生成代码产生的临时文件也会自动清理。

使用方式有两种：通过 pip 安装包，接入自己已运行的 Docker 容器；或克隆仓库，直接启动自带的 Docker Compose 服务，通过 /v1/run/ 接口以 REST 方式调用，任何语言都可以接入。

核心功能

  • 01执行前检查生成代码中的危险操作。
  • 02在独立的 Docker 容器中运行代码。
  • 03可配置 CPU、内存、swap 和超时限制。
  • 04支持 pip 依赖白名单与预缓存。
  • 05自带可直接启动的 Docker Compose REST API。
  • 06返回与本地运行 Python 一致的输出和错误堆栈。

适用场景

  • 让 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 容器。

收录于专题

AI 智能体沙箱开源 AI Agent 框架与应用

标签

#python#code-execution#sandbox#docker#llm#agents#rest-api

常见问题

AgentRun 是什么？
一个 Python 库和 REST API，在隔离的 Docker 容器中安全执行 LLM 生成的 Python 代码，并支持资源限制与超时控制。 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

概要由 AI 根据项目 README 生成；GitHub 数据每日更新。

相关项目