Библиотека и хостируемый сервис, предоставляющие AI-агентам изолированные Linux-подобные песочницы с файлами, процессами, shell и сетью на базе WebAssembly и V8.
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
Установите пакет Python
pip install capsule-run - 2
Создайте hello.py с задачей main, которая возвращает приветствие
- 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 обновляется ежедневно.
Похожие проекты
Изолированная среда WebAssembly для запуска кода на разных языках в браузере, Node.js или через MCP-сервер.
Python-библиотека для запуска кода, сгенерированного LLM, в изолированных песочницах через единый API для Docker, Kubernetes, Podman и локальных Linux- или Windows-бэкендов.
Среда выполнения WebAssembly и CLI для запуска приложений и кода AI-агентов в быстрых, лёгких и изолированных средах.
Open-source инфраструктура для запуска сгенерированного ИИ кода в изолированных облачных песочницах с JavaScript- и Python SDK.
Python- и JS/TS SDK для запуска сгенерированного ИИ кода в изолированных облачных песочницах и получения результатов его выполнения.