hyperlight-unikraft — Python в микро-ВМ для ИИ-агента
hyperlight-unikraft
Агент запускает Python в локальной микро-ВМ Hyperlight с собственным ядром: без сети и файлов хоста, с памятью между вызовами
- 49 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент исполняет произвольный код Python, и опции `hluk-arg` могут примонтировать каталоги хоста или открыть сеть, после чего изоляция ослабевает
- Установка hluk идет скриптом из репозитория через curl, поэтому скрипт стоит просмотреть до запуска
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/hyperlight-unikraftОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент исполняет произвольный код Python, и опции `hluk-arg` могут примонтировать каталоги хоста или открыть сеть, после чего изоляция ослабевает
- Установка hluk идет скриптом из репозитория через curl, поэтому скрипт стоит просмотреть до запуска
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий выпускает CLI hluk и библиотеку на Rust: они загружают ядро Unikraft в микро-ВМ Hyperlight, монтируют образ с пользовательским окружением и запускают программу за границей хоста с запретом по умолчанию. Файловая система и сеть открываются только флагами вроде `mount` и `net`, а прогретый гость сохраняется в снимок, и следующий запуск занимает миллисекунды. Шаблоны покрывают Python, Node.js, Bash, C#, Java, Go, Rust и другие языки. К агенту подключается MCP-сервер mcp-server-hyperlight из каталога integrations/mcp, он опубликован на PyPI. Инструмент run_python исполняет код Python 3.12 и сохраняет переменные и импорты между вызовами, как в блокноте. Инструмент reset_sandbox заменяет гостя свежим из снимка примерно за 60 мс на Linux с KVM. Вызов дольше 30 секунд останавливается, а гость подменяется.
Для кого. Разработчикам агентов и пользователям Claude Code и Cursor, которым нужно запускать сгенерированный моделью код Python изолированно и на своей машине
Подходит, если
- Агент считает данные или проверяет алгоритм в Python, а запускать чужой код на хосте не хочется
- Переменные и импорты должны жить между вызовами, как в блокноте Jupyter
- Облачные песочницы не подходят из-за аккаунта, ключа API или передачи кода наружу
- Нужны пакеты вроде `sympy` или `pandas`, и сети в гостя пускают только на конкретные хосты
- Хочется быстрый старт среды: гость поднимается из снимка примерно за 40 мс на Linux с KVM
Не подходит, если
- Код на другом языке: сервер MCP запускает только Python, остальные языки доступны через CLI hluk
- Нет гипервизора: нужны KVM или MSHV на Linux, WHP на Windows либо HVF на Mac с чипом Apple
- Задача требует многопоточных вычислений: у гостя один виртуальный процессор
- Результатом должна быть картинка: сервер возвращает только текст, изображение приходит как `repr`
Пример запроса к агенту
Запусти в песочнице Python, посчитай медиану и разброс по этому массиву чисел и оставь переменные в памяти для следующего шага.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
HLUK_INSTALL_DIR- Каталог, где установлен hluk, если клиент запускает сервер с другим PATH
Ограничения
Сервер работает только с Python и возвращает только текст. Пакеты, поставленные самим кодом через pip, исчезают после сброса, а переданные флагом package ставятся снова. У гостя один виртуальный процессор, потоки идут по очереди. Первый запуск скачивает образ около 400 МБ и сохраняет снимок около 800 МБ, это занимает от секунд до нескольких минут. В CI сервер проверяют на Linux и Windows, для Mac с чипом Apple проверок пока нет. Последний коммит сделан 6 ноября 2026 года.
Как отключить. Выполните `claude mcp remove hyperlight.` Загруженные образы и снимки гостя лежат в каталогах hluk, их удаляют вручную, если нужно освободить место.
Частые вопросы
Видит ли код файлы и сеть хоста?
По умолчанию нет. Каталоги и сеть открываются только флагами, например `hluk-arg` для монтирования и `net-allow` для хостов.
Нужен ли аккаунт или ключ API?
Нет. Сервер работает локально, код и данные остаются на машине.
Что нужно поставить, кроме сервера?
Консоль hluk версии 0.18.0 или новее и менеджер uv для запуска uvx. Аппаратный гипервизор: KVM или MSHV на Linux, WHP на Windows, HVF на Mac с чипом Apple.
Что происходит при ошибке или зависании кода?
Ошибка возвращается как трассировка в виде ошибки инструмента. Вызов дольше 30 секунд останавливается, гость заменяется, а модель узнает, что переменные потеряны.
Под какой лицензией проект?
Apache 2.0, проект входит в песочницу CNCF Hyperlight.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыБыстрый сервер MCP на Rust, расширяемый плагинами WebAssembly: плагины подтягиваются из OCI, файлов, http(s) и s3, подпись OCI можно проверять
Терминальный кодинг-агент на Python в манере Claude Code: читает репозиторий, правит файлы, запускает команды, с памятью, подагентами и MCP
Кодинг-агент для терминала, браузера и CI на 38 провайдерах моделей, с памятью между сессиями, MCP, скиллами и хуками.
Кодовый агент с ядром на Python и тремя интерфейсами: CLI для скриптов, TUI и приложение Electron, для моделей с API OpenAI
Локальный граф знаний о коде с историей версий: MCP-сервер отвечает агенту, кто вызывает функцию и что сломается от правки
MCP-сервер на Rust: агент запускает JavaScript и TypeScript в песочнице V8 одним инструментом run_js, состояние сохраняется
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| hyperlight-unikraft — Python в микро-ВМ для ИИ-агента (эта карточка) | да | не нужна | 49 | |
| LLM Sandbox MCP | нет | не нужна | 1 143 | изоляция на контейнерах Docker, а здесь микро-ВМ с собственным ядром и снимками |
| sandbox-mcp | нет | 422 | общий сервер песочниц, а здесь аппаратная изоляция и сохранение состояния между вызовами |
Коротко о README
В README описаны CLI hluk, шаблоны проектов, манифест hluk.toml, снимки прогретого гостя и четыре шага работы: загрузка, запуск, изоляция, снимок. Отдельный раздел перечисляет интеграции с `smolagents`, MCP, verl, OpenAI Agents SDK и ClickHouse, а в каталоге integrations/mcp лежит документация самого сервера.