Локальное развёртывание
Запустите Cradle Server на своём компьютере — одна команда, только localhost.
Всё на одной машине: cradle-server работает на вашем компьютере, а консоль на
opencradle.ai подключается к нему (топология T0). Путь по шагам со скриншотами —
Cradle на вашем компьютере; здесь —
команда установки и настройки.
[одна машина]
консоль (браузер) ──API──► cradle-server (локальные GPU/CPU)Установка
Нужны Node 22, pnpm и curl (macOS или Linux). Без root — ничего не пишется за пределами домашнего каталога:
curl -fsSL https://download.opencradle.ai/cradle-cli/latest/cradle-cli-install.sh | CRADLE_BIND=127.0.0.1 sh
~/.local/bin/cradle-server --data-dir ~/.local/share/cradle/data --port 31416 --bind 127.0.0.1Установщик распаковывает сервер в ~/.local/share/cradle, инициализирует базу и
сохраняет admin API-ключ в ~/.local/share/cradle/data/client-credentials.json.
Без CRADLE_BIND=127.0.0.1, как выше, установщик привязывает сервер к 0.0.0.0.
Если есть пользовательская сессия systemd, установщик сам запускает сервер как
службу, и вторая строка ответит, что порт уже занят.
Ключ нужен и для локальных запросов: вставьте его в консоли, когда нажмёте Подключить на карточке Этот компьютер.
Настройки
| Переменная / флаг | По умолчанию | Смысл |
|---|---|---|
--port | 31416 | порт HTTP API |
--data-dir | ~/.cradle | база, модели, admin-ключ |
CRADLE_BIND / --bind | 127.0.0.1 | CRADLE_BIND=0.0.0.0 открывает сервер для локальной сети |
Чтобы открыть доступ за пределы локальной сети, привяжите сервер к 0.0.0.0 и
поставьте перед ним reverse proxy (Caddy или nginx) для HTTPS — см.
развёртывание удалённого сервера.
Когда уходить с локальной машины
Локального развёртывания хватает одному оператору и умеренному потоку сообщений — узкое место здесь модель на GPU, а не встроенная SQLite. Переходите на выделенный GPU-сервер, когда нужна общая машина для нескольких клиентов, или на услугу ЦОД, когда нужна изоляция по тенантам.