Repolode
capsulerun

capsulerun/runtime

Среда выполнения кода для AI-агентов в изолированных песочницах WebAssembly с лимитами CPU, памяти и времени на каждую задачу.

Звёзды
303
Форки
22
Открытые issues
0
Последний коммит
25 дней назад

Что это?

Capsule — среда выполнения недоверенного кода в изолированной среде. Каждая задача запускается в собственной песочнице WebAssembly, отдельно от хост-системы. Разработчики оборачивают функции на Python или TypeScript/JavaScript в task-wrapper, после чего среда компилирует файл в WebAssembly и выполняет его.

Для каждой задачи можно задать уровень вычислительных ресурсов, лимит RAM, таймаут и число повторных попыток. Использование CPU контролируется с помощью fuel metering в WebAssembly. Доступ к файлам ограничен явно разрешёнными директориями с режимом только для чтения или чтения и записи, а исходящий сетевой доступ — списком разрешённых хостов. Переменные окружения доступны только в том случае, если они перечислены в списке. Каждый запуск возвращает JSON-объект с результатом, сведениями об ошибке и метриками выполнения, такими как длительность, израсходованный fuel и пиковое потребление памяти.

Проект предоставляет CLI (capsule run, capsule build), а также SDK для Python и npm, включая функцию run() для вызова задач в песочнице из кода хоста. Для запуска в песочнице Python-пакетам, использующим C extensions, нужна сборка wasm32-wasi.

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

  • 01Запускает каждую задачу в собственной песочнице WebAssembly, изолированной от хоста.
  • 02Ограничивает использование CPU с помощью fuel metering, а также задаёт лимиты RAM и времени для каждой задачи.
  • 03Ограничивает доступ к файлам указанными директориями с режимом только для чтения или чтения и записи.
  • 04Разрешает исходящие HTTP-запросы только к доменам из списка разрешённых.
  • 05Поддерживает задачи на Python и TypeScript/JavaScript с автоматическими повторами.
  • 06Возвращает структурированный JSON с результатом, длительностью, расходом fuel и метриками памяти.

Сценарии использования

  • Выполнение кода, сгенерированного LLM, в интерпретаторе кода без доступа к хост-машине.
  • Запуск вызовов инструментов AI-агентами со строгими ограничениями на файлы, сетевые хосты и переменные окружения.
  • Упаковка небольших функций в стиле serverless с предсказуемыми лимитами ресурсов.
  • Вызов изолированного кода на Python или TypeScript из хост-приложения через run().

Быстрый старт

  1. 1

    Установите пакет Python

    pip install capsule-run
  2. 2

    Создайте hello.py с задачей main, которая возвращает приветствие

  3. 3

    Запустите файл с помощью Capsule CLI

    capsule run hello.py

Что важно знать

  • В README приведены примеры только для Python и TypeScript, поэтому другие языки не рассматриваются.
  • Компиляция исходных файлов добавляет несколько секунд задержки при первом запуске, если не выполнить предварительную компиляцию с помощью capsule build.

В подборках

Темы

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

Что такое runtime?
Среда выполнения кода для AI-агентов в изолированных песочницах WebAssembly с лимитами CPU, памяти и времени на каждую задачу. Capsule — среда выполнения недоверенного кода в изолированной среде. Каждая задача запускается в собственной песочнице WebAssembly, отдельно от хост-системы. Разработчики оборачивают функции на Python или TypeScript/JavaScript в task-wrapper, после чего среда компилирует файл в WebAssembly и выполняет его.
runtime можно использовать бесплатно? Какая у него лицензия?
runtime распространяется с открытым исходным кодом под лицензией Apache-2.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
runtime всё ещё поддерживается?
Активно поддерживается. Последний коммит в runtime — 12 окт. 2026 г..
Для чего можно использовать runtime?
Выполнение кода, сгенерированного LLM, в интерпретаторе кода без доступа к хост-машине. Запуск вызовов инструментов AI-агентами со строгими ограничениями на файлы, сетевые хосты и переменные окружения. Упаковка небольших функций в стиле serverless с предсказуемыми лимитами ресурсов. Вызов изолированного кода на Python или TypeScript из хост-приложения через run().
Как установить runtime?
Установите пакет Python: pip install capsule-run Создайте hello.py с задачей main, которая возвращает приветствие Запустите файл с помощью Capsule CLI: capsule run hello.py
Где скачать runtime?
Исходный код и инструкции по установке — на GitHub: https://github.com/capsulerun/runtime

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

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

Библиотека и хостируемый сервис, предоставляющие AI-агентам изолированные Linux-подобные песочницы с файлами, процессами, shell и сетью на базе WebAssembly и V8.

4,9 тыс.+21 за неделю275RustApache-2.0Активно поддерживаетсяОбновлён 23 часа назад