Qubicl

Дайте любому ИИ-агенту настоящий личный компьютер на вашей машине.

Постоянные файлы. Доступ к терминалу. Веб-исследования. Постоянный браузер и рабочий стол. Перехват управления человеком в любой момент. Без аккаунта Qubicl, облачной плоскости управления или привязки к модели.

Быстрый старт · Почему Qubicl · Компьютеры · Клиенты · Безопасность · Документация

npm install -g qubicl-cli

Qubicl превращает локальный Docker в наблюдаемые компьютеры для внешних ИИ-агентов. Агент остаётся в Codex, Claude, Open WebUI, Cursor, VS Code или другом MCP- или OpenAPI-клиенте. Qubicl предоставляет машину, на которой работает агент.

your model or agent
        │
        │  MCP / OpenAPI / Open Terminal
        ▼
 localhost-only Qubicl gateway
        │
        ├── terminal + managed processes
        ├── durable, host-visible files
        ├── keyless web search + local extraction
        ├── persistent Chromium + desktop
        ├── packaged, operator-controlled skills
        └── live viewer + human takeover

Почему Qubicl

Related MCP server: EdgeBox

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

Требования: Linux с Docker Engine или Docker Desktop, macOS с Docker Desktop, либо Windows 11 через WSL 2 и Docker Desktop — плюс Node.js 22 или 24 и Docker Compose 2.24+. Нативный запуск в Windows и WSL 1 не поддерживаются; в установках WSL состояние Qubicl и домашние каталоги компьютеров должны храниться в файловой системе WSL Linux в каталоге /home.

qubicl setup

Мастер настройки проверяет Docker, сравнивает пресеты компьютеров, показывает предварительный расчёт диска и ресурсов, получает выбранные образы и может создать первый компьютер. Запускайте Qubicl от обычного пользователя, никогда не используйте sudo.

Создайте ещё один компьютер и подключите агента:

qubicl create computer-name --preset computer
qubicl connect computer-name --client codex

Команда connect выводит конфигурацию клиента; она никогда не редактирует файлы клиента и не печатает bearer-токен. Для локальных stdio-клиентов конфигурация не содержит токенов.

git clone https://github.com/EldanRing/qubicl.git
cd qubicl
npm ci
npm run images:build
npm install -g --prefix "$HOME/.local" ./packages/cli
export PATH="$HOME/.local/bin:$PATH"
qubicl setup

Выберите компьютер

Пресеты используют общие слои, но предоставляют разные контракты возможностей. Инструменты, которые выбранный компьютер не может поддержать, отсутствуют при обнаружении.

Каждый пресет включает встроенный web_search без ключей, локальный web_extract и шесть проверенных базовых навыков, нативных для Qubicl, с постоянными рабочими копиями, доступными агенту для редактирования. Операторы выбирают, какие инструменты и навыки предоставляет каждый компьютер:

qubicl tools computer-name
qubicl skills computer-name

Отключённые инструменты исчезают из MCP, OpenAPI и Open Terminal, а кэшированные вызовы завершаются отказом.

Подключите любого агента

qubicl connect computer-name --client codex
qubicl connect computer-name --client claude-code
qubicl connect computer-name --client cursor
qubicl connect computer-name --client opencode
qubicl connect computer-name --client openclaw
qubicl connect computer-name --client hermes-agent
qubicl connect computer-name --client open-webui

Адаптеры охватывают Codex, Claude Code, Claude Desktop, Cursor, VS Code, Open WebUI, универсальные stdio- и HTTP-MCP-клиенты, а также прямой OpenAPI. Статические профили могут предоставлять сокращённый каталог файлов, семантического браузера, визуального браузера или рабочего стола.

Для Open WebUI скопируйте созданную конфигурацию в Admin Panel → Settings → Integrations → Open Terminal. Qubicl предоставляет встроенные просмотр и поиск постоянных файлов, загрузку файлов в чат через файловую систему, скриншоты, браузерные инструменты и явно опубликованные локальные предпросмотры, не входя в Docker-сеть Open WebUI.

Точные инструкции см. в Настройка клиентов.

Наблюдайте и перехватывайте управление

qubicl view computer-name

Наблюдение пассивно. Перехват управления ограничивает инструменты агента и завершает его обычные управляемые команды, прежде чем передать вам клавиатуру и мышь. Постоянный браузер и явно управляемые настольные приложения остаются видимыми, поэтому вы можете продолжить ту же задачу, а не начинать заново.

Пока агент действует, viewer удерживает зелёный указатель Qubicl в последней позиции на рабочем столе или в управляемом браузере и коротко подсвечивает точную цель клика. Семантические клики в браузере проецируются с элемента страницы через Chromium и живой канвас noVNC, поэтому индикатор остаётся выровненным при изменении размера viewer и появлении полей letterboxing. Он появляется перед отправкой ввода, переживает перезагрузку viewer и исчезает, когда агент теряет аренду или управление перехватывает человек. Он существует только в viewer — ввод человека, веб-страницы и скриншоты агента не затрагиваются — и его можно отключить из заголовка viewer.

Если управляющий viewer исчезает, Qubicl снимает оставленное управление после короткого льготного периода на переподключение. Оператор всегда может восстановить управление явно:

qubicl control release computer-name

Создан для повседневного использования

• Публикуйте локальное веб-приложение, запущенное агентом, через аутентифицированный loopback-предпросмотр.

• Создавайте резервные копии, проверяйте, шифруйте, восстанавливайте, клонируйте и создавайте контрольные точки постоянных домашних каталогов.

• Применяйте политики исходщего трафика offline, web-only, developer или собственные.

• Предоставляйте строго ограниченные учётные данные, не помещая секрет в рабочую нагрузку.

• Импортируйте ограниченные определения devcontainer и используйте Git-процессы при посредничестве хоста.

• Включайте SSH только через loopback для редакторов и обычных ssh/scp.

• Просматривайте приватный журнал аудита без содержимого и диагностируйте топологию с помощью doctor.

• Обновляйте компьютер на месте, сохраняя его ID, токен, политику, ресурсы и домашний каталог.

Используйте qubicl help или qubicl <command> --help, чтобы изучить весь CLI.

Граница безопасности

Qubicl удерживает каждый компьютер в одной явной границе ресурсов и файловой системы Docker. Компьютеры работают без привилегированного режима, Docker-сокета, пространств имён хоста, произвольных монтирований и повышения привилегий без пароля. Шлюз прослушивает только 127.0.0.1; Chromium сохраняет своё пространство имён Linux и sandbox-механизмы seccomp-BPF для рендерера; файлы, доступные модели, ограничены постоянным домашним каталогом. Процессы контроллера и рабочей нагрузки находятся в одном контейнере компьютера, поэтому перехват управления человеком — это кооперативное ограничение управляемых процессов, а не граница для враждебного кода.

Qubicl — это компьютер на основе Docker для доверенных рабочих нагрузок или рабочих нагрузок под наблюдением оператора, а не граница виртуальной машины против враждебных пользовательских образов, эксплойтов ядра, компрометации Docker или другого пользователя, контролирующего учётную запись хоста. Сетевой профиль developer по умолчанию разрешает исходящий доступ. Прежде чем полагаться на эту границу, прочитайте