FAQ¶
Частые вопросы о запуске, провайдерах, правах и доступе. Если ответа нет — см. Диагностика.
Общее¶
Что такое Synth?
Synth — агентная платформа для команд и разработчиков. Люди и LLM-агенты работают в одной среде: человек задаёт направление, агент выполняет работу с файлами, shell и git. Всё — в едином веб-интерфейсе, с общей историей и аудитом. Подробнее — Что такое Synth.
Чем Synth отличается от обычного чата с LLM?
Обычный чат только отвечает текстом. Synth даёт агенту инструменты: он читает и изменяет файлы, запускает команды, работает с git, ведёт план проекта и todo сессии. Плюс роли и права, общая история на сервере, аудит запросов и режимы, в которых агент спрашивает подтверждение перед действиями.
Нужен ли интернет?
Не обязателен. С локальными моделями (например, через Ollama) можно работать полностью без внешних сервисов. Интернет нужен, только если вы подключаете облачного провайдера или корпоративный сервер.
Установка и запуск¶
Можно ли работать локально, без сервера и Keycloak?
Да. Команда synth serve поднимает локальный сервер и интерфейс на одной
машине — без бэкенда, Keycloak и Kubernetes. Рабочий каталог, история и
настройки остаются у вас. Подробнее —
Локальный запуск.
Как подключить свою модель?
Добавьте провайдера: через веб-интерфейс в разделе «Провайдеры» или командой
synth config provider add. Поддерживаются Ollama, OpenAI-совместимые и
Anthropic-совместимые API. Подробнее —
Провайдеры и модели.
Как обновить версию?
В интерфейсе, установленном как приложение, появится баннер обновления — подтвердите его. Подробнее — Мобильный интерфейс и PWA.
Данные и безопасность¶
Где хранятся ключи провайдеров?
В командном режиме ключи провайдеров хранятся только на сервере и не попадают к клиентам. В локальном режиме ключи остаются в вашем каталоге данных. Ключ доступа к самому Synth вводится в интерфейсе или передаётся команде при запуске. Подробнее — Безопасность.
Куда попадает история переписки?
Сессии и сообщения хранятся на сервере (в локальном режиме — на вашей машине), а не в браузере. Поэтому историю видно с другого устройства после входа, а несколько пользователей могут работать в одной сессии. Подробнее — Сессии и проекты.
Что уходит в LLM и что маскируется?
В модель уходит контекст сессии: ваши сообщения и необходимые фрагменты файлов проекта. LLM Gateway скрывает секреты (токены, ключи, пароли) до отправки, ограничивает частоту запросов и пишет журнал аудита — кто, когда и какую модель вызывал. Подробнее — Безопасность.
Возможности¶
Как добавить скилл?
Скиллы описываются в файлах SKILL.md и подключаются на уровне инстанса,
проекта или сессии. Готовые скиллы можно включать и отключать в настройках, а
команды вызывать через / в поле ввода. Подробнее —
Скиллы и команды.
Есть ли мобильное приложение?
Отдельного приложения в магазинах нет. Интерфейс Synth адаптирован под телефоны и планшеты, а установить его можно как приложение (PWA) прямо из браузера. Подробнее — Мобильный интерфейс и PWA.
О проекте¶
Где исходный код и под какой лицензией?
Репозиторий — gitverse.ru/itphx/synth. Лицензия — MIT: код можно свободно использовать, изменять и распространять. Юридическую силу имеет английский текст лицензии в репозитории.