Установка и эксплуатация
Что нужно, чтобы поднять сервис, и какие темы эксплуатации ещё без пошаговых статей.
Этот раздел про стенд, а не про кнопки редактора. Пошаговые статьи про обновление, резервные копии и квоты появятся отдельно. Ниже — то, что уже следует из репозитория.
Требования
- Node.js 22.13 или новее (
package.jsonиinstall.sh). - Python 3.12 (
requires-pythonвpyproject.tomlдвижка). - Docker и Docker Compose для обычного режима. Без Docker установщик предлагает только
--mode local. - Менеджеры репозитория: TypeScript — yarn, Python — uv.
Как поставить
Из клона репозитория ./install.sh собирает CLI и запускает мастер lct onboard. Флаги мастера перечислены в CLI. Мастер спрашивает режим, провайдера модели и администратора, затем может поднять стек.
Файл compose.yaml в корне называется проектом lct26 и поднимает сервисы postgres, engine, api, search и web. Команды lct start, lct stop, lct status, lct logs и lct restart вызывают Docker Compose из корня репозитория.
Предупреждение
В документацию не копируются значения из .env.example. Там лежат локальные пароли примера.
Секреты создаёт lct onboard и хранит их только в .env.
Модели
Провайдеры мастера: vk, ai-studio, openai, offline. Адреса и имена моделей читаются из переменных окружения, среди них LLM_BASE_URL, VLM_BASE_URL, IMAGE_BASE_URL, LLM_MODEL, VLM_MODEL, IMAGE_MODEL, MODEL_API_KEY, MODEL_PROVIDER. Полный список имён — в .env.example. Ключ в интерфейс и в эту документацию не попадает.
Аккаунты и квоты
Вход держит веб-сервер. Как устроены cookie и заголовки, написано в доступе к API.
Ограничения аккаунта необязательны. В контракте accountPolicySchema есть лимиты на генерацию, ответ ассистента, картинки, правки, параллелизм и хранилище. Меняет их администратор. Статья с экранами и периодами сброса будет позже; схема уже видна в справочнике.
Что ещё будет отдельными статьями
- обновление уже установленного стенда;
- резервная копия тома Postgres (
postgres-data) и каталоговdata/иruns/; - разбор
lct doctorпо каждому пункту.
lct doctor уже проверяет Node, Docker, Compose, buildx, свободное место, администратора, что секреты установки не пустые и не взяты из примера, и отвечает ли модель. Если API или веб не запущены, он пишет адрес http://localhost:3001/health и http://localhost:3000 и подсказывает lct start.