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