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