void-box CLI
Запускает каждый этап агента в отдельной микровиртуальной машине: Claude, Codex, Ollama или любой CLI с трассировкой OTLP
- 89 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агенты запускаются с ключами провайдеров и могут получать токены репозитория; изоляция ограничивает ущерб, но выдачу секретов настраивает пользователь.
Установка
- Работает в
Ручная установка
curl -fsSL https://raw.githubusercontent.com/the-void-ia/void-box/main/scripts/install.sh | shПервая команда из README ставит CLI `voidbox`; сначала прочитайте скрипт. Затем `voidbox run --file <спека>`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агенты запускаются с ключами провайдеров и могут получать токены репозитория; изоляция ограничивает ущерб, но выдачу секретов настраивает пользователь.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
void-box изолирует каждый этап работы агента в собственной микровиртуальной машине: на Linux через KVM, на macOS через Virtualization.framework. Внутри запускают Claude Code, Codex, Ollama, LM Studio, OpenRouter или любую программу из `PATH`. Этапы объединяют в конвейеры и описывают их в YAML-спеках, есть параллельное ветвление `.fan_out()` и слияние через `.pipe()`. В README описаны быстрый возврат из снимка (около 138 мс теплый и 252 мс холодный), образы OCI из GHCR, работа без прав root через пользовательскую сеть SLIRP и трассы OTLP по каждому этапу. Токены вроде `GITHUB_TOKEN` выдают только тому этапу, которому они нужны. Запуск идет командой `voidbox run --file <спека>`.
Для кого. Инженерам, которые запускают агентов с доступом к репозиториям и секретам и хотят ограничить ущерб от промпт-инъекции аппаратной границей.
Подходит, если
- Двухэтапный ревью-конвейер: анализатор читает чужой код, а токен для PR получает только второй этап
- Параллельные ветки исследования с разными наборами скиллов собираются в один отчет
- Локальную модель через Ollama или LM Studio запускают без ключей и без выхода в облако
- Нужны трассы и метрики по каждому шагу агента в стандарте OpenTelemetry
Не подходит, если
- Достаточно обычного контейнера Docker: микровиртуальные машины требуют KVM или Virtualization.framework
- Нужен простой агентский MCP-сервер без изоляции и конвейеров
- Машина без виртуализации, например некоторые облачные виртуалки без вложенного KVM
Пример запроса к агенту
Запусти исследовательский конвейер из examples/hackernews/hackernews_agent.yaml и покажи трассу по этапамОграничения
Нужна поддержка KVM на Linux либо Virtualization.framework на macOS. Установщик в README запускается через `curl ... | sh`: проверяйте скрипт до запуска. Учетные данные хозяина, например OAuth-токены, монтируются в гостя только на чтение, API-ключи передаются как переменные окружения сессии. Для Rust-сборки нужна версия 1.88 или новее. Часть примеров, включая торговый конвейер, учебная и требует собственных ключей провайдеров.
Как отключить. Удалите бинарный файл `voidbox` (при установке через Homebrew `brew uninstall voidbox`) и каталоги образов и снимков, которые он создал.
Частые вопросы
Как установить void-box?
Выполните `curl -fsSL https://raw.githubusercontent.com/the-void-ia/void-box/main/scripts/install.sh | sh`. Есть варианты `brew install the-void-ia/tap/voidbox` и `cargo install void-box`.
Нужны ли права root?
Нет. Сеть работает в пользовательском режиме через SLIRP на `smoltcp`, без TAP-устройств и повышенных привилегий.
Какие модели и агенты можно запускать?
Claude Code, OpenAI Codex, Ollama, LM Studio, OpenRouter, Together AI и любой Anthropic-совместимый адрес. Провайдер выбирается одним полем конфигурации.
Чем это отличается от smolvm?
void-box строит многоэтапные конвейеры агентов с трассами OTLP и снимками, а smolvm решает задачу запуска одной изолированной машины.
Как проверить, что установка прошла?
Запустите пример `voidbox run --file examples/hackernews/hackernews_agent.yaml` из README. Первый запуск и настройку провайдеров описывает раздел Getting Started на сайте документации.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыArcBox запускает Claude Code в одноразовой микровиртуалке на Mac: своя ОС, пустая рабочая папка и старт примерно за секунду
AgentBox запускает Claude Code, Codex и Open Code в отдельных виртуальных машинах: на вашем ПК, своем сервере или в облаке.
ExitBox запускает Claude, Codex, Cursor и других агентов в rootless-контейнерах: сеть по списку доменов, секреты в сейфе.
ClaudeBox запускает Claude Code в Docker с профилями языков, слотами сессий и фаерволом по списку разрешенных адресов.
Docker-песочница для кодинг-агентов: образ на Debian с Copilot CLI, Codex и Pi, а доступ по SSH, RDP и Docker включается флагами.
CLI создает для каждой фичи свое рабочее дерево Git и окружение, чтобы агенты и люди работали параллельно без конфликтов
Коротко о README
README обещает аппаратную изоляцию каждого этапа агента, показывает сценарии: исследовательский конвейер, ревью с PR, шлюз OpenClaw для Telegram и локальные модели, затем сравнивает подход с контейнерами, описывает защиту и способы установки.