Перейти к содержанию

CLI

Публикуемая CLI-обёртка @itphx/synth умеет запускать сервер, работать с провайдерами и общаться с моделью прямо из терминала.

Когда удобен CLI

CLI пригодится, чтобы поднять сервер одной командой, быстро спросить модель без открытия браузера или настроить провайдера на машине, где нет доступа к веб-интерфейсу.

Установка

Нужен Node.js 22 или новее.

npm install -g @itphx/synth
synth --version

docker run -p 4300:4300 -e SYNTH_API_KEY=my-secret-key \
  gitverse.ru/itphx/synth

После запуска откройте http://localhost:4300 и введите тот же ключ.

Запуск сервера: synth serve

Одна команда поднимает ядро и веб-интерфейс:

synth serve --api-key my-secret-key

По умолчанию сервер слушает http://127.0.0.1:4300. Откройте этот адрес в браузере и введите ключ.

Ключ API

Задать ключ можно любым из способов — приоритет у первого.

synth serve --api-key my-secret-key

SYNTH_API_KEY=my-secret-key synth serve

Если ключ не задан, Synth сгенерирует устойчивый локальный ключ, сохранит его в каталоге данных и напечатает при старте. Введите его в интерфейсе при входе.

Ключ — это доступ

Ключ даёт доступ к вашему инстансу Synth и всем инструментам агента. Не передавайте его третьим лицам и не публикуйте в открытых репозиториях.

Основные параметры serve

Параметр Назначение
--port <number> Порт сервера (по умолчанию 4300)
--host <host> Адрес прослушивания (по умолчанию 127.0.0.1)
--api-key <key> Ключ аутентификации
--data-dir <path> Каталог данных (сессии, проекты, настройки)
--home <path> Локальный home-каталог: конфиг и данные в одном месте
--connect <url> Подключиться к корпоративному серверу (гибридный режим)

Чат из терминала

Можно общаться с моделью, не открывая браузер.

synth chat "привет" --provider ollama --model qwen3:14b

synth chat --provider ollama --model qwen3:14b

Введите сообщение и нажмите Enter. Выход — exit или quit.

synth

Команда без аргументов сразу открывает интерактивный чат.

Полезные флаги chat: --provider, --model, --agent, --api-key (ключ провайдера) и --data-dir.

Провайдеры и модели из CLI

Провайдеры хранятся как JSON-файлы в каталоге данных, но управлять ими удобно командой synth config provider.

# Локальные модели через Ollama
synth config provider add \
  --name ollama --type ollama \
  --url http://localhost:11434/v1 \
  --model qwen3:14b

# OpenAI-совместимый API
synth config provider add \
  --name my-openai --type openai \
  --url https://api.openai.com/v1 \
  --model gpt-4o \
  --api-key sk-xxx

synth config provider list

synth config provider delete ollama

Обязательные флаги — --name и --type (openai, anthropic, ollama). Опциональные — --url, --model, --api-key, --data-dir. Модель по умолчанию задаётся флагом --model; выбрать модель для конкретной сессии и проверить её доступность удобнее в разделе «Провайдеры» веб-интерфейса. Подробнее — Провайдеры и модели.

Гибридный режим

Чтобы работать с локальными и корпоративными проектами в одном интерфейсе, подключите локальное ядро к серверу:

synth serve --connect https://synth.example.com

После запуска войдите в интерфейс логином и паролем (или API-ключом сервера). Подробнее — Гибридный режим.

Что дальше