Rakazo — открытая агентская платформа (Apache-2.0, 5 408 звёзд на GitHub) с постоянными ботами, памятью и собственными компьютерами в песочницах. Разбираем установку из готовых образов, требования по железу и настройку публичного доступа.
Rakazo разворачивается одной командой из опубликованных Docker-образов: установщик скачивает compose-файлы, генерирует секреты и поднимает стек на http://127.0.0.1:5173. Дальше остаётся подключить модель и решить, где живут «компьютеры» ботов — локально в Docker или в удалённой песочнице E2B, Daytona, CreateOS или Boat. Ниже — рабочий порядок установки, требования и места, где чаще всего ломается.
Rakazo — открытая платформа персональных агентов: каждый бот получает свои диалоги, память, расписания и историю, а работать он может на «компьютере» — изолированном контейнере с браузером, терминалом, файлами и графическим рабочим столом. В README проект описан как self-hosted альтернатива Grok Bot, Meta Muse, OpenAI Dots, Instinct, OpenClaw и Hermes Agent.
Смысл self-host здесь не только в приватности. Модель вы подключаете своим ключом (поддерживается OpenRouter и другие провайдеры через Pi), а данные и история переписок остаются на вашем сервере в Postgres. Для команд, которые не готовы отдавать рабочие переписки в чужой SaaS, это ключевой аргумент.
docs/self-host.md репозитория на 23.10.2026, метрики — из GitHub API (звёзды, форки, лицензия, даты). Собственного развёртывания на этом хосте мы не делали: страница описывает официальную процедуру, а не наш опыт эксплуатации в продакшене.Rakazo — это не статический сайт, а долгоживущий API: веб-интерфейс, Graphile Worker для фоновых задач, Postgres и провайдер компьютеров. Понимание этой схемы экономит время при диагностике: половина проблем установки связана не с приложением, а с тем, что контейнер-супервизор не смог поднять песочницу.
| Компонент | Роль | Что ломается чаще всего |
|---|---|---|
| Веб (порт 5173) | Интерфейс и API-прокси | Публикация без TLS и неверные origins в .env |
| Postgres | Все данные, история, память ботов | Пароли ролей и строка подключения |
| Graphile Worker | Расписания и фоновые задачи | Не стартует без миграций |
| Docker-супервизор | Локальные компьютеры ботов | Отсутствие SANDBOX_SUPERVISOR_TOKEN |
| Удалённая песочница | E2B, Daytona, CreateOS, Boat | Неверный SANDBOX_PROVIDER или пустой ключ |
Для установки из готовых образов не нужны ни Node, ни сборка: достаточно Docker Engine 26+ (нужен API 1.45+ из-за подмонтирования подкаталогов томов), плагина Compose, curl и openssl. Требование к версии Docker здесь не формальность — на старом движке не работает изоляция домашних каталогов ботов.
| Компонент | Версия / значение | Обязателен |
|---|---|---|
| Docker Engine | 26+ (API 1.45+) | да |
| Docker Compose plugin | актуальный | да |
| curl, openssl | любые из дистрибутива | да |
| Node.js | 22.22.2+, 24.x или 26+ | только для сборки из исходников |
| pnpm | 9 | только для сборки из исходников |
| Свободный порт | 5173 | да, по умолчанию |
RAKAZO_COMPUTER_MEMORY=2g, RAKAZO_COMPUTER_CPUS=2, RAKAZO_COMPUTER_PIDS_LIMIT=2048. Ноль, none или unlimited снимают потолок — на сервере с несколькими ботами этого лучше не делать.Установщик идемпотентен: он не перезаписывает существующий .env при повторном запуске и умеет работать в два шага. Второй шаг нужен, если вы хотите заранее поменять провайдера песочниц, домен или тег образа — тогда сначала --prepare-only, правка .env, затем обычный запуск.
mkdir -p rakazo && cd rakazo && curl -fsSLO https://raw.githubusercontent.com/elie222/rakazo/main/infra/compose/install-images.sh
bash install-images.sh
http://127.0.0.1:5173
OPENROUTER_API_KEY=...
SANDBOX_PROVIDER=docker
bash install-images.sh --prepare-only # правим .env: SANDBOX_PROVIDER, RAKAZO_HOST, ключи провайдеров bash install-images.sh
Тег образа по умолчанию — edge, то есть сборки из main. Каждый публикуемый образ multi-arch (amd64 и arm64), поэтому на ARM-серверах отдельный тег не нужен. Стабильного latest на 23.10.2026 нет: последний релиз — v0.3.3, и в документации прямо сказано не рассчитывать на latest.
Провайдер песочниц задаётся переменной SANDBOX_PROVIDER. По умолчанию это docker: контейнеры живут на том же сервере, отдельный аккаунт у внешнего сервиса не нужен. Удалённые провайдеры нужны, когда ботов много или когда контейнеры с браузером нельзя держать рядом с приложением.
| Провайдер | Где исполняется код | Когда выбирать |
|---|---|---|
| docker | На том же сервере, под управлением супервизора | По умолчанию: проще всего, не нужен внешний аккаунт |
| e2b | Удалённые песочницы E2B | Когда нужна изоляция от основного сервера |
| daytona | Удалённые рабочие пространства Daytona | Когда нужны быстрые холодные старты |
| createos | Облачные компьютеры CreateOS | Когда нет своего железа под контейнеры |
| boat | Песочницы Boat | Для серверных конфигураций, рекомендованных в документации |
| railway | Шаблон развёртывания Railway | Когда нужен хостинг без администрирования сервера |
compose up падает по fail-closed — это защита, а не баг. Токен генерируется установщиком; при ручной правке .env его надо сохранить.Смысл серверной установки в том, что боты продолжают работать, когда ваш ноутбук выключен. Порядок тот же, но перед запуском надо поменять три публичных origin на HTTPS-адрес и выставить RAKAZO_HOST. Образы Compose слушают только loopback, поэтому TLS терминируется на хосте или в отдельном Caddy.
app.example.com {
reverse_proxy 127.0.0.1:5173
}| Переменная | Значение | Зачем |
|---|---|---|
| BETTER_AUTH_URL | https://ваш.домен | Авторизация должна знать свой публичный адрес |
| WEB_ORIGIN | https://ваш.домен | Проверка origin для веб-клиента |
| API_URL | https://ваш.домен | Тот же origin: /api и /rpc проксируются приложением |
| RAKAZO_HOST | ваш.домен | Хост, под которым инстанс представляется клиентам |
| SANDBOX_PROVIDER | boat / e2b / daytona / createos | Удалённые компьютеры вместо локального Docker |
Отдельный нюанс — электровное приложение: вариант «This computer» само поднимает опубликованные образы через Docker Compose на порту 45173, чтобы не конфликтовать с pnpm dev на 5173. Если порт занят, приложение выбирает и запоминает другой loopback-порт. Это удобно для локальной работы, но для командного использования нужен именно серверный инстанс.
По звёздам GitHub Rakazo пока младше соседей по классу: 5 408 против 103 671 у Orca и 78 731 у ruflo. Но проект создан 13 августа 2026 года и уже набрал 958 форков — динамика важнее абсолютной цифры, а релиз v0.3.3 вышел 22 октября.
Почти все сбои установки упираются в четыре вещи: версия Docker, секреты, провайдер песочниц и публичные origin. Ниже — короткий чек-лист, который закрывает большинство случаев из документации.
compose up падает сразу — проверьте SANDBOX_SUPERVISOR_TOKEN: пустое значение останавливает стек по fail-closedWEB_ORIGIN, API_URL и BETTER_AUTH_URL должны совпадать с публичным HTTPS-адресомRAKAZO_DOWNLOAD_BASEdocs/self-host.md — установка и публичный доступ, self-host-secrets.md — список секретов и правила их несмешивания, self-host-restricted-network.md — работа за блокирующим файрволом. Для установки «агентом» в репозитории есть SETUP_PROMPT.md..env выставляются RAKAZO_HOST и три публичных origin с HTTPS, а TLS ставится перед портом 5173 (например, Caddy). После этого к инстансу подключаются десктоп- и мобильные клиенты.OPENROUTER_API_KEY в .env либо любой поддерживаемый провайдер в онбординге. Для Amazon Bedrock с ролевой авторизацией на хосте документация предлагает PI_DEFAULT_CREDENTIALS=host.SANDBOX_PROVIDER; для удалённых нужен ключ соответствующего сервиса, тарифы — на сайте провайдера.