Локальное развёртывание

Самый быстрый способ попробовать Cradle — запустить всё на одной машине. Desktop приложение уже содержит встроенный cradle-server, поэтому для локальной работы достаточно только его.

Вариант A — desktop-приложение

1. Скачайте Cradle с страницы загрузок.
2. Установите и запустите.
3. Приложение автоматически:
   • создаёт директорию пользовательских данных,
   • инициализирует SQLite + sqlite-vec,
   • загружает встроенные правила рисков,
   • генерирует первый admin:* API-ключ.

После запуска откройте Integrations → HTTP API, чтобы увидеть ключ или сгенерировать scoped-ключ.

Вариант B — headless cradle-server

Если вы хотите CLI-only или подключать desktop с другой машины:

pnpm install
pnpm build:server
node dist/server/index.js --data-dir ~/.cradle --port 31416

При первом старте сервер выведет JSON-строку с freshly generated admin API key. Скопируйте её:

cradle login --url http://127.0.0.1:31416 --key ck_live_...

Проверка

cradle health
# или
curl -H "Authorization: Bearer ck_live_..." http://127.0.0.1:31416/api/v1/health

Загрузка первой модели

cradle models list
cradle models pull qwen3-0.6b-q4   # маленький классификатор
cradle models pull qwen3-8b-q4     # основная chat-модель

Подключение Telegram

1. Создайте бота у @BotFather и получите токен.
2. В Cradle откройте Integrations → Telegram, вставьте токен, включите канал.
3. Напишите боту — сообщение появится в Inbox или получит автоответ.

Подключение виджета

1. В Integrations → Web Chat Widget включите канал.
2. Скопируйте embed-snippet и вставьте на любую страницу.
3. Виджет будет общаться с Cradle через WebSocket на порту 31415.

Что дальше

• Добавьте базу знаний.
• Настройте GPU-сервер.
• Прочитайте про HTTP API.