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

Быстрый старт

Synth можно поставить тремя способами. Выберите подходящий: npm — самый быстрый, Docker Compose — если не хотите ставить Node.js, из исходников — для разработки.

После любого способа откройте UI по адресу http://localhost:4300 и введите API-ключ.

Способ 1. npm (глобальная установка)

Быстрее всего — установить публикуемую CLI-обёртку @itphx/synth. Она поднимает core и UI одной командой.

npm i -g @itphx/synth

ollama pull qwen3:14b

SYNTH_PROVIDER_OLLAMA_URL=http://localhost:11434/v1 \
SYNTH_PROVIDER_OLLAMA_MODEL=qwen3:14b \
SYNTH_PROVIDER_OLLAMA_TYPE=ollama \
SYNTH_API_KEY=my-secret-key \
synth serve

Откройте http://localhost:4300 и введите ключ my-secret-key.

Способ 2. Docker Compose

Подходит, если не хотите устанавливать Node.js. Docker Compose поднимет Synth (и, при желании, Ollama).

git clone https://gitverse.ru/itphx/synth && cd synth

echo "SYNTH_API_KEY=my-secret-key" > .env

docker compose up -d

Откройте http://localhost:4300 и введите ключ my-secret-key. Логи — docker compose logs -f synth.

Ollama в Compose

Ollama вынесена в отдельный профиль. Запустите docker compose --profile ollama up -d, затем загрузите модель: docker compose exec ollama ollama pull qwen3.5.

Способ 3. Из исходников (разработка)

Для участия в разработке. Требуются Node.js >= 22 и pnpm >= 11.

git clone https://gitverse.ru/itphx/synth && cd synth
pnpm install

pnpm build

node packages/synth/dist/cli.js serve --api-key my-secret-key

Для разработки удобен ./scripts/dev.sh (backend + UI, порты и переменные уже настроены).

После запуска

  • Адрес: UI отдаётся вместе с пакетом @itphx/synth-ui и доступен на http://localhost:4300 (host и порт — --host / --port).
  • Ключ: если --api-key не задан (--api-key / SYNTH_API_KEY / core.apiKey), synth serve сгенерирует устойчивый ключ, сохранит его в {dataDir}/secrets/api-key и напечатает при старте. Локальный API-ключ core даёт роль ADMIN.
  • Провайдер: чтобы получать ответы модели, подключите провайдера — Провайдеры и модели.

Что дальше