Документация — Luxify Assistant

Установка

Что понадобится

Windows 10 или 11, 64-разрядная. Отдельно ставить .NET не нужно.
Микрофон — встроенный или внешний.
Около 1 ГБ свободного места и интернет для активации, первой загрузки голосов и моделей распознавания и обновлений. Сама речь распознаётся без сети.

Где взять установщик

Скачать программу можно после покупки: в личном кабинете или на странице, которая откроется после оплаты. Если к аккаунту привязан Telegram, подтверждение оплаты придёт и туда.

Как установить

Запустите скачанный файл.
Дождитесь окончания установки. Права администратора не нужны: программа ставится в ваш профиль Windows (%LocalAppData%\Luxify.Assistant).
Запустите Luxify Assistant с ярлыка.
После активации появится «Загрузка компонентов…»: программа скачает модели распознавания и голос (установщик весит около 90 МБ, компоненты — около 300 МБ). Остальные голоса докачаются в фоне.

Если на компьютере осталась старая версия из Program Files, программа один раз предложит её удалить. Ваши команды и настройки сохранятся.

Обновления устанавливаются сами: новая версия скачивается в фоне и ставится при следующем запуске. Обновления получают все, в том числе без подписки.

Активация

Активация связывает программу с вашим аккаунтом Luxify и привязывает к нему компьютер. Пароля нет — войти можно через Telegram или по почте, кодом из письма.

Запустите программу. Откроется окно «Активация» с кодом из восьми символов.
Нажмите «Открыть страницу входа». Если код не подставился сам, нажмите в программе «Скопировать код», вставьте его на странице и нажмите «Продолжить».
Войдите кнопкой Telegram, ссылкой «Войти через бота Telegram» (если кнопка не появилась) или по почте — кодом из письма. Уже вошедшему на сайте достаточно подтвердить вход.
Проверьте название устройства и нажмите «Подтвердить вход».
Вернитесь в программу — она сама привяжет компьютер и загрузит ваши покупки.

Код действует около 10 минут. Истёк — нажмите «Получить новый код».

Никому не сообщайте код. Если его просят продиктовать или «подтвердить» в переписке — в ваш аккаунт пытается войти кто-то другой. Нажмите на странице «Это не я».

Если свободных мест под компьютеры нет, откроется окно «Лицензия занята» — см. Компьютеры и отвязка.

Первые команды

Проверьте, что микрофон включён: кнопка с микрофоном — в правом верхнем углу главного окна.
Поставьте пак Windows (см. Паки команд) — появятся команды для окон, звука и системы.
Скажите команду обычной фразой: «сделай громче», «сверни все окна», «смени раскладку».
Результат видно в «Истории команд» главного окна: что услышано и что выполнено.

Фразы «открой …» и «запусти …» ищут программы и файлы в папках из «Настройки → Поиск файлов».

Справа в главном окне — «Панель управления»: режим префикса, анимация аватара, «Окно поверх» и громкость программы.

Голосовой ввод

Всё про распознавание — в «Настройки → Голосовой ввод».

Движок распознавания. «Локальная модель» работает на компьютере и без интернета. В Plus — облачные: «Luxify Распознавание» (без своего ключа, нужен только вход в аккаунт) и «OpenAI (облако)» с ключом OpenAI, ProxyAPI или AITUNNEL («Настройки → ИИ-провайдер»). Смена движка применяется после перезапуска.
Язык распознавания речи — «Авто», «Русский» или «English».
Модель микрофона — какое устройство слушать. По умолчанию — системное.
Чувствительность распознавания и чувствительность префикса — если программа реагирует на посторонние звуки, уменьшите; если не слышит — увеличьте.
Автовключение микрофона — слушать сразу после запуска программы.

Обращение (префикс)

По умолчанию обращение — «джарвис». Его можно сменить в поле «Префикс», в том числе на несколько слов через запятую. Уже созданные команды при этом менять не нужно.

Режим префикса выключен (по умолчанию) — команда сработает и с обращением, и без него.
Режим префикса включён — выполняются только фразы, которые начинаются с обращения, сказанного в той же реплике. Без обращения в истории появится «Нужен префикс».

Режимы переключаются и голосом — фразами из «Фраз режимов»: «перейди в режим префикса», «перейди в тихий режим», «хватит слушать».

Язык самой программы — «Настройки → Интерфейс → Язык интерфейса»: русский или английский.

Редактор команд

Команды хранятся деревом: коллекция → папка → команда. Коллекция — верхний уровень («Джарвис», «Работа», «Управление YouTube»), команда создаётся внутри папки.

Создать команду

Откройте «Редактор команд» (значок на левой панели).
Нажмите «Создать коллекцию», затем выберите её и нажмите «Создать папку».
Выберите папку и нажмите «Создать новую команду», заполните «Название».
Нажмите «Действие», выберите его в «Списке действий» и нажмите «Вставить». Действий может быть сколько угодно, порядок меняется перетаскиванием. Какие бывают действия — в разделе Действия.
Заполните параметр действия: ссылку, путь к программе, сочетание клавиш, текст.
В «Фразах для активации» укажите, что говорить. В «Необязательные фразы» — слова, которые можно сказать до или после: «открой», «пожалуйста».
Нажмите «Сохранить» в карточке команды, а затем «Сохранить» на панели дерева — только тогда команда записывается на диск.

Фразы

Обязательная фраза — смысловое ядро команды: «рабочий режим». Необязательные — служебные слова по краям, их можно сказать или пропустить: «включи рабочий режим», «рабочий режим, пожалуйста». Если фраза совпадает с фразой другой команды, программа предупредит ещё до сохранения.

Карточка команды

Подтверждать — перед выполнением Luxify спросит подтверждение. Ответ голосом: «да», «правильно», «подтверждаю» или «нет», «отмена». Без ответа через 30 секунд — отмена. Слова меняются в «Настройки → Выполнение команд».
Связывать PLUS — команду можно запускать в связке с другими, см. Сценарии.
Запись действий PLUS и Создать с помощью AI PLUS — см. Сценарии.

Дерево

Кнопка питания в строке выключает команду, папку или всю коллекцию. Выключенная команда остаётся в дереве, но не выполняется; включили папку обратно — всё вернулось как было.
Поиск в шапке находит коллекции, папки, команды и фразы. Enter — следующее совпадение, Esc — очистить.
Правая кнопка мыши — редактировать, добавить фразу, клонировать, копировать (в том числе как JSON), вставить, экспортировать, удалить, развернуть или свернуть всё.
Импорт и экспорт — файлом JSON, в том числе перетаскиванием файла в окно. Так удобно делиться командами и переносить их на другой компьютер. Если в присланных командах есть скрипты, запуск или запись файлов, выключение — программа покажет их и включит подтверждение.
Порядок и вложенность меняются перетаскиванием.

Действия

Всё, что может сделать команда. Действия разложены по десяти группам в «Списке действий»; в строке команды действие можно и напечатать — появятся подсказки.

Запуск

Открыть сайт — ссылка, например https://youtube.com.
Запустить файл или программу — путь к .exe или любому файлу.
Выполнить команду CMD PLUS — например ipconfig; keep: ipconfig оставит окно открытым.
Выполнить команду PowerShell PLUS — команда или путь к .ps1.

Клавиши

Нажать клавишу или сочетание — нажмите сочетание прямо в поле параметра: Ctrl+Shift+Esc, Win+R, F5, стрелки.
Ввести текст — готовый текст на любом языке, с переносами строк.
Сохранить (Ctrl+S), Нажать Enter.

Мышь

Левый, правый, двойной клик, клик колесом; правый клик несколько раз.
Переместить курсор в координаты (X Y) и сдвинуть курсор на расстояние или в сторону.
Прокрутить колесо (3 — вверх, -3 — вниз), прокрутить вверх или вниз.
Зажать левую или правую кнопку на заданное время.
Перетащить от текущей точки или из точки в точку (x1 y1 x2 y2).

Программа

Пауза в секундах, миллисекундах или минутах — ждать перед следующим шагом.
Свернуть Luxify в трей.

Озвучка

Готовые фразы выбранного голоса по разделам: подтверждения, приветствия, запуск и действие, готовность и статус, система, звук и громкость, музыка и медиа, управление окнами, отмена и остановка, программа, протоколы. См. Голоса.

Звук

Воспроизвести WAV или MP3 — путь к аудиофайлу.
Произнести мужским или женским голосом — любой текст голосом Windows.
Громкость приложения — меняет громкость одной программы в микшере Windows, а не всей системы: +10, -10, 50 или mute, после ; — процессы через запятую (+10;spotify); без имени — активное окно.

Система

Установить громкость (0–100), увеличить или уменьшить на N процентов.
Заблокировать экран, выключить или включить монитор, спящий режим.
Выключить и перезагрузить компьютер — при сохранении такой команды программа сама предложит включить «Подтверждать».

Браузер

Найти в интернете — откроет результаты поиска по запросу.
Открыть первый результат поиска — сразу перейдёт по первой ссылке.

Текст

Диктовка Windows — открывает стандартную диктовку (Win+H), чтобы надиктовать текст в активное поле.

Файлы

Создать папку — путь к новой папке.
Записать текст в файл — файл|текст, например C:\Temp\a.txt|привет. Запись файлов-скриптов (.bat, .cmd, .ps1 и подобных) — только в PLUS.

Сценарии

Сценарий — это обычная команда из нескольких действий. Одна фраза — и программа выполняет шаги по порядку. Сценарии из любого числа действий есть в программе без подписки.

Пример: «Протокол „У нас гости“»

Нажать клавишу или сочетание — Win+D (свернуть все окна).
Установить громкость — 0.
Открыть сайт — например, кинопоиск.
Озвучка — «Протокол выполнен».

Фразы для активации: «протокол у нас гости», «у нас гости».

Советы

Между запуском программы и нажатием клавиш в ней ставьте паузу на 1–3 секунды — программе нужно время открыться.
Координаты мыши зависят от разрешения экрана: на другом мониторе клики могут промахнуться. Где можно — используйте сочетания клавиш.
Заканчивайте сценарий фразой озвучки — так понятно, что всё выполнено.
Опасные шаги (выключение, перезагрузка) — только с «Подтверждать».

Связка команд PLUS

Несколько готовых команд одной фразой: «открой ютуб и сделай громче». Слова-связки по умолчанию — «и», «затем», «потом» (меняются в «Настройки → Выполнение команд»). В связке участвуют команды с отметкой «Связывать».

Запись действий PLUS

Нажмите «Запись действий» в карточке команды, сделайте всё руками и нажмите «Стоп» на плавающем индикаторе. Клики, прокрутка, набранный текст, сочетания клавиш, запуск программ и паузы станут обычными шагами — их можно поправить. Движение мыши покадрово не записывается: перед каждым кликом курсор просто переносится в нужную точку.

Создать с помощью AI PLUS

Опишите команду словами — «открой Яндекс Музыку и сделай потише» — проверьте предложенные шаги и нажмите «Создать». Используются только существующие действия, команда не сохраняется сама. Нужна подключённая нейросеть (см. Luxify AI).

Паки команд

Пак — готовый набор команд для программы, сайта или игры. После установки это обычная коллекция в редакторе: её можно менять, выключать и удалять.

Откройте «Дополнения» → вкладка «Команды».
Найдите пак поиском или по категориям справа.
Нажмите «Установить» и выберите язык команд: русский, английский или оба.
Отметьте нужные папки — внизу видно, сколько команд будет установлено. Нажав на команду, можно заранее посмотреть её фразы и действия.
Подтвердите установку. Паки скачиваются с сервера — нужен интернет.

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

Программы установщик находит на компьютере сам. Если программы нет, берётся её веб-версия, а если нет и её — команда пропускается; сколько пропущено, видно в окне установки.

В программе — категория «Команды по умолчанию»: Windows, Google Chrome, YouTube, Telegram, Spotify, Word, Яндекс Музыка, и «Готовый пак команд по умолчанию» — все семь одной коллекцией. В Plus — ещё 41 пак: общение, браузеры, дизайн, видео и музыка, работа и игры (Steam, Counter-Strike 2, Minecraft, Dota 2, Fortnite, PUBG, League of Legends), и «Все готовые сценарии» — 11 сценариев вроде «Доброе утро», «Режим кино» и «Пора спать».

Команды игровых паков — обычные нажатия клавиш с управлением по умолчанию. Если вы меняли управление в игре, поправьте сочетание в команде.

Голоса

Luxify отвечает вслух голосом персонажа. Голоса входят в программу:

Marvel — Джарвис, Пятница, Эдит, Карен, Альтрон, Вижн;
Portal — GLaDOS;
MiSide — Мита;
Atomic Heart — ХРАЗ.

Голос выбирается в «Настройки → Озвучка», громкость — там же. Фразы голоса можно вставлять в свои команды действием из группы «Озвучка».

Синтез речи

Ответы Luxify AI и действия «Произнести…» озвучиваются голосом Windows. В PLUS доступны облачные голоса: «Luxify Озвучка» — голоса Fish Audio без своего ключа, а также OpenAI (с ключом OpenAI, ProxyAPI или AITUNNEL) и Fish Audio со своим ключом — «Настройки → Синтез речи».

Luxify AI PLUS

Чат с нейросетью внутри программы, который умеет выполнять ваши команды.

Ключ не нужен. По умолчанию Luxify AI работает через «Luxify AI Облако» — без своего ключа и без VPN, с месячным лимитом. Нужно больше или хочется другую нейросеть — подключите свой ключ. На выбор 12: OpenAI, Anthropic (Claude), Google Gemini, xAI (Grok), DeepSeek, YandexGPT, GigaChat, посредники OpenRouter, ProxyAPI и AITUNNEL (оплата в рублях, без VPN), локальная модель (Ollama, LM Studio — бесплатно и без интернета) и свой OpenAI-совместимый сервер. Запросы оплачиваются у сервиса; подписка ChatGPT не подходит. У Gemini и GigaChat есть бесплатный лимит.

Откройте «Настройки → ИИ-провайдер» и выберите провайдера. «Где взять ключ» подскажет, где его получить.
Вставьте ключ в поле «Ключ API» и нажмите «Проверить подключение». Затем «Сохранить».
Откройте Luxify AI (значок на левой панели).

Что умеет: отвечает на вопросы, ищет свежие данные в интернете, читает изображения и документы (DOCX, XLSX, текст и код; PDF — нет), делает снимок экрана, создаёт изображения и файлы (TXT, MD, CSV, JSON, XLSX, DOCX), выполняет ваши команды, понимая запрос по смыслу. Режим — в «Настройки Luxify AI»: «Только ИИ», «Только управление ПК» или «Комбинированный»; поиск, картинки и файлы работают в комбинированном. Картинки умеют OpenAI, Gemini, Grok и посредники ProxyAPI и AITUNNEL; если у выбранного сервиса такой возможности нет, программа возьмёт другой сохранённый ключ.

Голосом

Включите «Активация голосом по префиксу» в «Настройки Luxify AI». Тогда «Джарвис, расскажи про Марс» уйдёт в Luxify AI, а «Джарвис, открой Telegram» выполнится как обычная команда. Без обращения в нейросеть ничего не отправляется. Несколько секунд после ответа можно продолжать без обращения, прервать ответ — «стоп».

Telegram и аватар PLUS

PC Control — управление из Telegram

Плагин запускает команды из редактора через вашего личного Telegram-бота. Компьютер должен быть включён, программа запущена, интернет подключён.

В Telegram откройте @BotFather, создайте бота командой /newbot и скопируйте токен.
В программе: «Дополнения» → «Плагины» → шестерёнка на карточке PC Control.
Вставьте токен в поле «Токен бота (BotFather)».
Заполните «Telegram ID владельца»: напишите своему боту (пока ID не указан, он пришлёт его в ответ) или спросите @userinfobot.
Включите «Включить PC Control» и нажмите «Сохранить».

/menu (или слово «меню») открывает папки и команды из редактора. Команду можно написать и текстом. Изменили команды в программе — нажмите в меню «Обновить».

Бот выполняет только сообщения владельца, остальные игнорирует.
Команды с отметкой «Подтверждать» запускаются только кнопкой из меню, после «Подтвердить».
Выключенные команды в меню не показываются. Голосовые сообщения пока не поддерживаются.

Visual Avatar

Анимация поверх экрана — концентрические круги, как на главной программы. Реагирует на голос ассистента, микрофон или системные звуки, не мешает кликам и умеет прилипать к краям экрана. Включается в «Дополнения» → «Плагины», настройки — шестерёнкой на карточке.

Компьютеры и отвязка

Покупка программы даёт одно место под компьютер. Ещё два добавляются в личном кабинете кнопкой «Добавить компьютер» — всего до трёх. Plus действует на всех привязанных компьютерах.

Новое место не занимают переустановка программы, обновления Windows и переименование компьютера. Переустановка Windows считается сменой компьютера.

Если все места заняты

Программа откроет окно «Лицензия занята»: там видно, какой компьютер занимает место и когда он был активен. Можно «Отвязать тот компьютер и активировать этот» или купить ещё одно место (если мест меньше трёх).

Отвязка в кабинете

Откройте luxify-assistant.com/account и войдите — через Telegram или по почте.
В разделе «Компьютеры» нажмите «Отвязать».

Отвязывать самостоятельно можно не чаще раза в 30 дней — иначе вместо кнопки видна дата, когда отвязка станет доступна. Сломался компьютер — напишите в поддержку. «Выйти везде» компьютеры не отвязывает.

Без интернета

Команды и распознавание речи работают без сети всегда. Возможности Plus без подключения действуют до трёх суток, потом программа попросит подключиться. Срок подписки без интернета не продлевается.

Подписка и отмена

Luxify Plus оплачивается помесячно или за год (так выгоднее). Пробного периода нет. Plus дополняет программу: если её ещё нет, программа добавляется к первому платежу, а дальше продлевается только Plus.

Автопродление

Plus оформляется только с автопродлением: в конце периода оплата списывается с карты, которой вы платили. После списания в Telegram приходит «Подписка продлена» с датой следующего списания.

Как отменить продление

Откройте личный кабинет и войдите — через Telegram или по почте.
В разделе «Подписка» нажмите «Отменить продление».

Оплаченный период действует до конца, дальше деньги не списываются. Передумали до конца периода — «Включить продление обратно».

Переход с месяца на год

В кабинете нажмите «Перейти на год» и оплатите год: 12 месяцев добавятся к уже оплаченному периоду, дальше подписка продлевается раз в год.

Если списание не прошло

По окончании оплаченного периода возможности Plus отключаются. Трое суток мы пробуем списать оплату снова и сообщаем об этом в Telegram. Когда оплата пройдёт, всё вернётся.

Без подписки

Программа продолжает работать — она куплена навсегда. Отключаются Luxify AI, связки, запись действий и плагины; облачное распознавание заменяется встроенным, своё оформление — стандартным. Команды с CMD или PowerShell и команды из паков Plus остаются в редакторе, но не выполняются. Настройки не удаляются и вернутся после продления.

Частые проблемы

Микрофон не слышит

Проверьте кнопку микрофона в главном окне и устройство в «Настройки → Голосовой ввод → Модель микрофона». В параметрах конфиденциальности Windows должен быть разрешён доступ к микрофону. Если программа слышит, но путает слова, — увеличьте «Чувствительность распознавания» или говорите ближе к микрофону.

Команда не срабатывает

«Нужен префикс» — начните фразу с обращения или выключите «Режим префикса».
«Команда выключена» — включите её (или её папку) в редакторе.
«Команда не найдена» — проверьте «Фразы для активации» и что дерево сохранено кнопкой «Сохранить».
Короткая фраза пака («пауза») работает, только когда окно сервиса активно, — добавьте название сервиса: «ютуб пауза».

Пак не запускает программу

Программа не найдена на компьютере — установщик пака взял веб-версию или пропустил команду. Укажите путь к .exe в действии «Запустить файл или программу» или добавьте папку в «Настройки → Поиск файлов».

Команда в игре не нажимает клавиши

Проверьте, что игра — активное окно, а сочетание в команде совпадает с управлением в игре. Некоторые игры с защитой от читов не принимают программные нажатия — это ограничение игры.

«Нет ключа» или ошибка нейросети

«Luxify AI Облако», «Luxify Распознавание» и «Luxify Озвучка» работают без ключа, но нужны вход в аккаунт и Plus; месячный лимит облака виден в программе. Со своим ключом: выберите провайдера в «Настройки → ИИ-провайдер», добавьте ключ и нажмите «Проверить подключение».

«Не удалось загрузить компоненты»

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

Windows пишет «Система Windows защитила ваш компьютер»

Так Windows встречает новые программы без издательской подписи. Нажмите «Подробнее» → «Выполнить в любом случае». Скачивайте установщик только из личного кабинета.

«Файл команд занят»

Антивирус или синхронизация OneDrive иногда на время блокируют файл команд — программа об этом предупредит. Приостановите их и повторите сохранение.

«Доступно только в Plus»

Нажмите на строку в истории — откроется предложение подписки. Уже оплатили — «Уже купил — обновить».

«Не удалось проверить права» или нет интернета

Это не значит, что прав нет: команды работают и без сети, а возможности Plus — до трёх суток. Подключитесь к интернету и нажмите «Повторить проверку».

Не нашли ответ

Поддержка: Telegram — @lux_support, почта — luxify.assistant.support@gmail.com.