Что есть что
cradle-server, CLI cradle и веб-консоль — части системы, что где ставится и что не нужно ставить вообще.
Прежде чем что-то устанавливать, стоит различать три вещи. Имена похожи, но роли разные, и ставятся они в разные места.
Три компонента
| Что это | Где живёт | Откуда ставится | |
|---|---|---|---|
cradle-server | Демон. Держит SQLite-базу, модели, RAG и каналы (Telegram, виджет, HTTP API). Единственный компонент, который реально выполняет работу | на сервере | пакет cradle-cli |
cradle | Тонкий HTTP-клиент. Своей базы и моделей нет — каждая команда это вызов к /admin/* какого-то сервера | где угодно: и на сервере, и на ноутбуке | тот же пакет cradle-cli |
Пакет называется cradle-cli, но привозит оба бинаря — и демон, и клиент.
Название историческое, из имени префикса в бакете загрузок.
Почему CLI оказывается и на сервере
cradle — не «клиентская половина» какого-то приложения. Это инструмент управления сервером,
работающий откуда угодно: на самом сервере он обращается к localhost:31416,
с ноутбука — к http://<адрес-сервера>:31416. Команды одни и те же.
Кроме того, именно через него выполняется развёртывание: cradle server init —
не работа с данными, а операторская команда, которая создаёт базу, первый
API-ключ и systemd-unit. Поэтому CLI нужен на сервере с самого начала.
Что с чем не связано
Сервер и консоль — не части одной установки. Консоль — веб-страница, а сервер работает там, где вы его запустили:
- Только ноутбук, работа локально → запустите сервер на своём компьютере.
Консоль найдёт его на
localhost:31416. - Общий сервер, тяжёлые модели, несколько пользователей →
разверните
cradle-serverи подключайтесь к нему из консоли или из CLI.
Типичная последовательность
- На сервере (один раз) — installer ставит
cradle-serverиcradle, создаёт базу и выдаёт первый admin-ключ. - Запуск демона — через systemd (если есть root) или вручную командой
cradle-server. - Подключение клиента — на выбор:
cradle login --url http://<адрес-сервера>:31416 --key ck_live_..., дальшеcradle agents,cradle models pull,cradle health;- либо веб-консоль на opencradle.ai, если удобнее GUI.
Шаг 3 можно делать и с самого сервера, и с ноутбука — это одна и та же команда
с разным --url.
Что такое Cradle?
Cradle запускает команды ИИ-агентов и проверяет их работу. Проект — это команда: капитан, лиды с исполнителями и Checker. Здесь же сказано, что работает сегодня, а что в планах.
Cradle на вашем компьютере
От одной команды до первой команды агентов — сервер на своём компьютере, консоль находит его, модель подбирается под железо.