От загрузки до первого чата

1. Установите Node.js

Установите Node.js 22 с официального сайта, выбрав свою систему и процессор. npm входит в комплект. Откройте новое окно терминала и проверьте версии. Нужны интернет и собственный аккаунт AI-провайдера.

node --version
npm --version

2. Распакуйте архив

Windows: правой кнопкой по ZIP → «Извлечь всё». macOS: двойной щелчок по ZIP. Linux: «Распаковать» в файловом менеджере. Используйте отдельную папку SYNVOX, не запускайте внутри ZIP и не распаковывайте поверх старой версии.

3. Установите зависимости

Откройте папку с package.json. Windows: в адресной строке Проводника введите cmd и нажмите Enter. macOS/Linux: в Терминале введите cd с пробелом, перетащите распакованную папку в окно и нажмите Enter. Выполните команду и дождитесь загрузки зависимостей и браузеров — это может занять несколько минут.

npm ci

4. Запустите программу

Выполните команду в той же папке. Оставьте терминал открытым. Для последующих запусков нужна только эта команда; для остановки нажмите Ctrl+C в терминале.

npm start

5. Подключите AI и проект

Выберите провайдера, войдите в свой аккаунт через предложенное окно авторизации. Создайте чат, выберите модель и папку проекта. Сначала попросите описать проект без изменения файлов. Проверьте разрешения в настройках перед правками и командами. Используйте копию проекта или отдельную Git-ветку. Аккаунты и лимиты сторонних AI в SYNVOX не входят.

6. Ключ и подписка

Доступ управляется в «Настройки → Подписка»: 3 пробных дня, затем 99 ₽ за 30 дней через YooKassa либо 100 Telegram Stars, без автопродления. Платёж привязывается к ключу установки. Не публикуйте ключ. При проблеме с активацией обратитесь в поддержку с номером заказа.

Если не запускается

Нужна помощь? Отправьте ОС, версию Node.js и текст ошибки. Удалите ключи, cookies и пароли. stas.sor@gmail.com

Подробно: Windows

1. Скачайте Node.js 22 LTS для Windows по ссылке выше. Запустите установщик MSI, оставьте установку npm и добавление в PATH включёнными.
2. Скачайте ZIP SYNVOX. В «Загрузках» нажмите по нему правой кнопкой → «Извлечь всё». Откройте вложенную папку SYNVOX — внутри должны быть package.json и папки bin и src.
3. Нажмите адресную строку Проводника, введите cmd и нажмите Enter. Откроется терминал именно в этой папке. Не запускайте его от имени администратора.
4. Введите по очереди команды ниже. Дождитесь завершения npm ci, затем запускайте npm start. Если в PowerShell запрещён npm.ps1, используйте cmd или команды npm.cmd ci и npm.cmd start; менять политику безопасности не нужно.

node --version
npm --version
npm ci
npm start

Подробно: macOS

1. Установите Node.js 22 LTS для macOS с официального сайта. Закройте старые окна Терминала и откройте новое.
2. В Finder откройте «Загрузки», дважды нажмите ZIP. Перенесите распакованную папку SYNVOX, например, в «Документы».
3. Откройте Finder → «Программы» → «Утилиты» → «Терминал». Введите cd, затем пробел. Перетащите папку SYNVOX из Finder в Терминал и нажмите Enter.
4. Введите ls: в списке должен быть package.json. Затем выполните npm ci, дождитесь окончания и выполните npm start. Не используйте sudo.

Подробно: Linux

1. Установите Node.js 22 или новее и npm способом, указанным на официальном сайте Node.js для вашей системы. Проверьте node --version и npm --version.
2. Распакуйте ZIP через файловый менеджер. Откройте терминал в папке SYNVOX с package.json (обычно пункт «Открыть в терминале» в меню папки).
3. Выполните npm ci, затем npm start. Нужна графическая сессия рабочего стола. Если браузеру не хватает системных библиотек, передайте точную ошибку поддержке; не запускайте приложение с root и не отключайте sandbox.

Первый вход и проверка работы

1. После запуска дождитесь окна SYNVOX. Первый запуск может занять больше времени из-за подготовки браузера. Терминал оставьте открытым.
2. Выберите AI-провайдера и откройте вход в его аккаунт. Пароль вводите только на странице самого провайдера. Если есть CAPTCHA или подтверждение входа, пройдите их самостоятельно.
3. Откройте папку проекта. Для первой проверки используйте копию проекта. Создайте чат, выберите модель и отправьте: «Ответь одним словом: готово». Затем попросите описать проект без изменения файлов.
4. Настройки → «Подписка»: проверьте дату окончания доступа. Для продления выберите YooKassa или Telegram Stars. Ознакомьтесь с документами и подтвердите согласия на открывшейся странице. Не отправляйте ключ установки в обычный чат.
5. При Telegram Stars переходите именно по ссылке из этой установки SYNVOX: она связывает бота с установкой. Выберите язык, выполните шаги согласия и привязки, затем оплатите выставленный счёт. Простого открытия бота недостаточно для привязки.
6. После оплаты вернитесь в SYNVOX и нажмите «Проверить статус». Дата доступа должна продлиться после серверного подтверждения. Если этого не произошло, не платите повторно: отправьте поддержке номер заказа, время и сумму платежа.

Мультиаккаунты Qwen находятся в Настройки → «Аккаунты». Добавьте второй аккаунт и включите автоматическое переключение. Оно применяется к поддерживаемым ответам об исчерпании квоты Qwen, а не ко всем ошибкам и не ко всем провайдерам.

Повторный запуск, остановка и обновление

Для повторного запуска откройте терминал в той же папке SYNVOX и выполните npm start. Повторять npm ci каждый раз не нужно. Для остановки вернитесь в терминал и нажмите Ctrl+C.

Перед ручным обновлением остановите программу и сохраните старую папку. Скачайте новую версию в отдельную папку, распакуйте, выполните npm ci и npm start. Не удаляйте пользовательские папки с чатами и авторизацией. Пробный период не начинается заново от переустановки. Этот ZIP не является автоматическим обновлением и не является установщиком EXE/DMG.

Если появляется EADDRINUSE / «порт занят», сначала закройте уже запущенную копию SYNVOX. При сетевой ошибке npm проверьте соединение и повторите установку; не отключайте проверку сертификатов. При пустом окне сохраните последние строки терминала и обратитесь в поддержку.

Управление компьютером: требования ОС

Обычный чат, задачи проекта и снимки встроенного браузера доступны независимо от режима рабочего стола. Для инструментов экрана, мыши и клавиатуры выберите «Компьютер» в конкретном чате.

• Windows: нужен активный рабочий стол пользователя. Не запускайте SYNVOX как службу. Shell использует cmd.exe; PowerShell можно вызвать явно как установленную программу.
• macOS: разрешите запись экрана и универсальный доступ в «Системные настройки → Конфиденциальность и безопасность» для процесса, которым запускаете SYNVOX.
• Linux: требуется графический сеанс X11 и переменная DISPLAY. Wayland пока не поддерживается для управления рабочим столом. В Ubuntu/Debian могут понадобиться libxtst6 libxrandr2 libxi6; зависимости браузера устанавливаются командой npx playwright install-deps chromium.

Нативные модули входят в зависимости npm. Если пакет @jitsi/robotjs отсутствует, повторите npm ci и сохраните ошибку установки. Полный ввод на Windows и работа с несколькими мониторами ещё требуют ручной проверки; ZIP остаётся альфа-версией.