Repolode
tjmlabs

tjmlabs/AgentRun

Библиотека Python и REST API для запуска кода Python, сгенерированного LLM, в изолированном Docker-контейнере с ограничениями ресурсов, тайм-аутами и проверками безопасности.

Open source альтернатива:OpenAI Code Interpreter

Звёзды
383
Форки
39
Открытые issues
9
Последний коммит
15 дней назад

Что это?

AgentRun позволяет приложению передавать код Python, написанный большой языковой моделью, в изолированную среду и получать результат, включая исключения и трассировки стека. Библиотека построена на Docker Python SDK и RestrictedPython; код выполняется в изолированном Docker-контейнере, а не на хостовой системе.

Перед выполнением код проверяется на опасные элементы. Разработчики могут задавать лимиты CPU, памяти и swap, а также тайм-аут выполнения (по умолчанию — 20 секунд) и разрешать установку только указанных pip-пакетов. Зависимости также можно заранее кэшировать в образе контейнера, чтобы ускорить последующие запуски, а артефакты, созданные сгенерированным кодом, автоматически удаляются.

Есть два способа использования: установить pip-пакет и подключить его к уже запущенному Docker-контейнеру или клонировать репозиторий и запустить готовую конфигурацию Docker Compose, которая предоставляет REST-эндпоинт /v1/run/ для вызовов из программ на любом языке.

Ключевые возможности

  • 01Перед запуском проверяет сгенерированный код на опасные операции.
  • 02Запускает код в изолированном Docker-контейнере.
  • 03Настраиваемые лимиты CPU, памяти и swap, а также тайм-аут выполнения.
  • 04Возможность формировать список разрешённых pip-зависимостей и кэшировать их заранее.
  • 05Поставляется с готовым к запуску REST API на Docker Compose.
  • 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.

В подборках

Темы

Частые вопросы

Что такое AgentRun?
Библиотека Python и REST API для запуска кода Python, сгенерированного LLM, в изолированном Docker-контейнере с ограничениями ресурсов, тайм-аутами и проверками безопасности. AgentRun позволяет приложению передавать код Python, написанный большой языковой моделью, в изолированную среду и получать результат, включая исключения и трассировки стека. Библиотека построена на Docker Python SDK и RestrictedPython; код выполняется в изолированном Docker-контейнере, а не на хостовой системе.
AgentRun можно использовать бесплатно? Какая у него лицензия?
AgentRun распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
AgentRun всё ещё поддерживается?
Активно поддерживается. Последний коммит в AgentRun — 23 окт. 2026 г..
Для чего можно использовать 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 проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Open-source среда выполнения песочниц для AI-агентов: изолированные окружения для запуска кода, команд, работы с файлами и браузерами на собственной инфраструктуре.

16,5 тыс.+176 за неделю1,6 тыс.PythonApache-2.0Активно поддерживаетсяОбновлён вчера