От установки до первого проекта: подключите свой ключ, выберите модель и поручите агенту задачу. Чат, облачная студия и локальные инструменты работают в одном приложении.
Инструкция относится к нашей desktop-сборке для Mac с Apple Silicon и Windows x64. Интерфейс при первом запуске открывается на русском. Существующая настройка языка сохраняется.
Откройте скачанный DMG и перенесите GenosAI Desktop Beta в «Программы».
Запустите приложение из «Программ». Если уже работает предыдущая beta, завершите её перед обновлением.
Если macOS попросит доступ к сохранённому ключу через Связку ключей, подтвердите системный запрос самостоятельно, если доверяете этой установленной сборке.
Эта сборка предназначена для процессоров Apple M-серии. Версия для Intel Mac пока не опубликована. Beta подписана локально и не прошла Apple notarization.
Запустите EXE-установщик. Он открывается на русском языке.
Выберите папку установки. Программа устанавливается для текущего пользователя.
Запустите GenosAI Desktop Beta через ярлык на рабочем столе или в меню «Пуск».
Windows-сборка экспериментальная: упаковка проверена, установка и запуск на реальном Windows ещё ожидают приёмки. Опциональные Code Mode и локальный inference в ней не включены.
Если ОС ограничит запуск неподписанной beta, действуйте по своим обычным правилам допуска тестового ПО. Для облачных запросов нужен интернет. Выделенный сервер, IP-адрес и установка отдельного GenosAI-плагина для стандартного подключения не нужны.
02 / Подключение
Вставьте личный API-ключ GenosAI
Получите ключ. Войдите в свой аккаунт GenosAI и создайте личный API-ключ. Проверьте права ключа и баланс аккаунта. Ключ предназначен для вашего приложения — не публикуйте его в чате или в исходниках.
Откройте раздел GenosAI в приложении. Найдите блок «Подключение GenosAI». Адрес сервиса уже настроен.
Вставьте ключ в поле «API-ключ GenosAI» и нажмите «Сохранить». При успешном подключении появляется сообщение о сохранении ключа, загружается каталог моделей и включаются встроенные инструменты GenosAI.
Проверьте владельца ключа. Под полем отображается блок «Аккаунт GenosAI» с именем и email, если они доступны в профиле. Кнопка «Обновить аккаунт» запрашивает сведения повторно. Для этого нужно право read:balance.
Выберите модель для чата. В настройках модели используйте провайдер GenosAI и подходящую текстовую модель из каталога. Для работы с инструментами выбирайте модель, которая поддерживает их вызов.
Один сохранённый ключ используется для чата, студии и встроенных GenosAI-инструментов. Возможности конкретного аккаунта зависят от прав ключа, баланса и доступности моделей у сервиса. Отдельные ключи поставщиков моделей для этого подключения не требуются.
Ключ хранится локально в зашифрованном виде средствами ОС. При удалении ключа сведения об аккаунте очищаются. Сведения об аккаунте не заменяются выдуманным именем при ошибке сети или недостаточных правах.
03 / Первый диалог
Создайте сеанс и задайте понятную задачу
Вернитесь на главный экран или создайте новый чат.
Если нужны файлы, выберите рабочую папку сеанса. Для независимого проекта удобно создать отдельную пустую папку.
Отправьте сообщение. Три фиолетовые точки мигают по очереди, пока агент работает.
Если агент запрашивает разрешение на инструмент или уточнение, ответьте в текущем чате.
Составь план презентации для клиента на 10 слайдов. Для каждого слайда напиши заголовок, основной тезис и идею иллюстрации. Отвечай по-русски. Сначала предложи структуру.
Чат — непрерывный разговор с общей историей и контекстом. Продолжайте его для доработки того же результата. Для другой темы создайте новый чат: это помогает держать контекст точным и уменьшать расходы.
04 / Практический пример
Соберите игру в крестики-нолики
Этот пример показывает полный путь от запроса до работающих файлов. Понадобится текстовая модель с поддержкой инструментов и доступ к выбранной папке.
Создайте пустую папку genosai-demo и выберите её рабочей папкой нового чата.
В инструментах или расширениях включите Developer — локальный инструмент чтения файлов, их изменения и запуска команд. По умолчанию он не включён глобально.
Отправьте запрос ниже. Просмотрите план агента и запросы разрешений.
После завершения проверьте, что в выбранной папке созданы HTML, JavaScript и, при необходимости, CSS. Названия зависят от решения агента.
Откройте HTML-файл через свою папку в браузере. Если игре нужен сервер, поручите агенту подготовить команду запуска и объяснить адрес. Запуск потребует установленной среды проекта и разрешения на команды.
Создай в выбранной папке браузерную игру «Крестики-нолики» на JavaScript: игрок против бота, кнопка новой игры, понятное сообщение о победе или ничьей. Интерфейс на русском. Сохрани все исходники в папке проекта. Не используй платные сервисы. Проверь логику и расскажи, как открыть игру.
Проверьте несколько партий: победа игрока, победа бота, ничья и новая игра. Затем продолжите чат: «Добавь выбор сложности и улучшай оформление, сохранив существующую логику». Для других задач так же можно поручить агенту написать Python-скрипт, веб-страницу или обработчик данных.
Ответ с фрагментом кода ещё не означает, что файл сохранён. Просите конкретно создавать файлы в рабочей папке и показывать ссылки на результат. Если локальные инструменты выключены, модель сможет объяснить решение, но не запишет файлы на компьютер.
05 / Материалы проекта
Храните исходники и результаты в одной папке
Выбирайте отдельную рабочую папку для каждого проекта. Внутри можно держать код, Python-скрипты, фотографии, видео, исходные документы и готовые результаты. Агент работает с ними через разрешённые локальные инструменты; папка не становится автоматически доступной облачной модели целиком.
Организуй выбранную папку проекта: исходники — в src, исходные материалы — в assets, готовые PDF и презентации — в outputs. Не перемещай существующие файлы без объяснения. Все результаты сохраняй сюда и выдавай кликабельные ссылки.
PDF и PPTX из ответа открываются через установленные программы на компьютере. Для PPTX нужен PowerPoint или другой совместимый редактор. Файл должен существовать в папке сеанса и оставаться доступным. Код и исполняемые файлы не запускаются обычным нажатием на ссылку документа — выполнение идёт через инструменты с разрешениями.
Для Python, Node.js и других языков нужна установленная среда и библиотеки проекта. Приложение не содержит универсального запуска любого языка. Перед командой полезно попросить агента проверить среду, перечислить недостающие зависимости и объяснить ожидаемый результат.
Для восстановления работы откройте сохранённый сеанс и убедитесь, что исходная папка не перемещена. Обновление программы не является резервной копией проектов: важные материалы храните также в своей системе резервного копирования или Git.
Документы / Встроенные форматы
Получайте готовые Word, Excel, PDF и PowerPoint
Встроенные инструменты создания документов доступны сразу после подключения ключа GenosAI: отдельные плагины, Python и Microsoft Office для сборки файлов не нужны. Работают в обычном чате и в режиме агента, если включён встроенный GenosAI.
Выберите рабочую папку проекта. В новом запросе укажите задачу, исходные данные и нужный формат: Word (.docx), Excel (.xlsx), PDF или PowerPoint (.pptx).
Для Word попросите документ с заголовками, абзацами, списками и таблицами. Приложение создаёт редактируемый DOCX и PDF для просмотра.
Для Excel укажите столбцы, данные и расчёты. Приложение создаёт XLSX с листами, числами, форматированием, фильтром и закреплённой строкой заголовков. Поддерживаемые формулы вычисляются перед сохранением.
Для презентации укажите тему и число слайдов. Можно собрать редактируемые текстовые слайды или использовать уже готовые изображения из задач GenosAI. Получите PDF и PPTX; новые изображения при повторном экспорте не генерируются.
После успешного сохранения в чате появится блок «Готовые файлы» с прямыми ссылками. Файлы и source.json сохраняются в отдельной папке GenosAI внутри выбранного проекта.
Создай краткое коммерческое предложение в Word и PDF, таблицу сметы в Excel с формулами и презентацию на 3 слайда в PowerPoint. Используй только эти исходные данные: […]. Сохрани реальные файлы в рабочую папку и дай ссылки. Не ограничивайся инструкцией по созданию.
Для открытия и ручного редактирования установите совместимый редактор документов. В PowerPoint, собранном из картинок, текст внутри картинки не редактируется; в текстовых слайдах — редактируется.
Excel поддерживает арифметику и функции SUM, AVERAGE, MIN, MAX, COUNT, COUNTA, IF, ROUND, ABS, AND и OR в пределах таблицы одного листа. Внешние ссылки, макросы и сложные межлистовые формулы не поддерживаются встроенным экспортом. Для нестандартных задач можно подключить соответствующий MCP или использовать локальные инструменты проекта.
Локальная сборка файлов не запускает платную генерацию медиа. Запросы к текстовой модели расходуют баланс API. Если задача генерации ещё выполняется, агент должен показать её текущий статус; готовые ссылки появляются после фактического сохранения.
06 / Облачные модели
Создавайте изображения, видео, речь и музыку
Откройте раздел GenosAI и блок «Студия GenosAI».
Выберите тип задачи и модель из доступного каталога.
Введите запрос и необходимые параметры модели. Если требуется референс, добавьте поддерживаемый файл.
Перед отправкой проверьте модель, параметры и действующую цену. Генерация списывает средства с вашего баланса.
Отправьте задачу, дождитесь её статуса и сохраните готовый результат.
Набор категорий включает текстовые задачи, изображения, видео, синтез речи, музыку и embeddings. У каждой модели свои обязательные параметры, размеры и форматы. Для embeddings нужен специальный сценарий работы с векторами; это не обычный собеседник.
Каталог загружается из API и обновляется автоматически примерно раз в пять минут. Кнопка «Обновить модели» выполняет обновление сразу. Новые модели существующих поддерживаемых категорий появляются без переустановки приложения. Новый тип API или протокол может потребовать изменения клиента.
Через чат агент тоже может пользоваться встроенными инструментами GenosAI: читать каталог и баланс, создавать задачи, получать их статус и историю. Для этого не нужно устанавливать GenosAI повторно. Доступность конкретных названий и версий, включая Claude и GPT, определяется живым каталогом.
При таймауте генерации сначала проверьте историю задач и её идентификатор. Запрос мог быть принят облаком, даже если ответ не дошёл. Повторная отправка может создать вторую оплачиваемую задачу. Приложение не повторяет такую генерацию автоматически.
Агенты / Готовые специалисты
Откройте режим агента одним нажатием
В боковом меню нажмите «Агенты». Приложение загрузит живой каталог GenosAI: названия и описания на русском, поиск по задаче и кнопки запуска. На дату проверки API вернул 26 агентов.
Сохраните личный API-ключ GenosAI, если ещё не подключались.
Откройте «Агенты» и найдите нужного специалиста: например, «Копирайтер», «Презентации» или «Дизайн интерьера».
Нажмите его карточку. Создаётся отдельный чат в режиме выбранного агента, с его моделью по умолчанию.
В чате видны название агента и приветствие. Опишите свою задачу; его инструкции GenosAI применяет на сервере.
Выберите рабочую папку, если нужны локальные файлы. Word, Excel, PDF, PowerPoint и сохранение готовых медиа доступны через встроенный GenosAI. Отвечайте на уточнения агента.
Открытие карточки не отправляет платный запрос модели. Оплата начинается после вашего сообщения или запуска генерации. Обычные чаты сохраняют свои настройки; при возвращении к сохранённому агентскому чату его режим восстанавливается.
Каталог обновляется автоматически раз в пять минут и кнопкой «Обновить». Новые публичные агенты, опубликованные сервисом через API, появляются без обновления приложения. Приватные, административные и закрытые тарифом агенты API не отдаёт.
В desktop нет кнопок экспорта из web-студии: агент создаёт файлы встроенными инструментами и возвращает прямые ссылки. Готовые изображения, видео и аудио можно сохранить из существующих задач. Специальные инструменты web-студии, например монтаж готового ролика или отдельный сценарий аватара, через API автоматически не подключаются; для них потребуется подходящий MCP или локальный инструмент.
07 / Подключения MCP
Добавьте инструменты других приложений
MCP — способ передать агенту инструменты внешнего сервиса. Подключить можно приложение, для которого существует совместимый MCP-сервер или адаптер. Действия и права определяет этот сервер: чтение, поиск, изменение данных и другие доступные операции.
Откройте «Подключения MCP» в боковой панели или раздел расширений в настройках.
Нажмите добавление собственного подключения и задайте понятное имя.
Выберите тип, который указан в документации нужного MCP-сервера: локальная команда stdio или адрес Streamable HTTP.
Для локального сервера укажите команду, аргументы и необходимые переменные среды. Для удалённого — адрес и предусмотренные сервером данные авторизации.
Сохраните и включите подключение. Проверьте доступные инструменты в сеансе. Если связь не установилась, проверьте запуск самого сервера и его требования.
Начните с простого запроса на чтение данных. Затем разрешайте конкретные изменения по необходимости.
Используйте настройки из официальной документации подключаемого сервиса. Универсальный пример с произвольным URL или командой не гарантирует совместимость. Для локальных серверов могут понадобиться Node.js, Python или иная среда; для внешних — отдельный аккаунт и права.
Встроенное подключение GenosAI создаётся приложением автоматически после сохранения ключа. Оно доступно и в возобновлённых чатах. Вы можете управлять доступом инструментов для конкретного сеанса; отключённый вручную инструмент не следует считать доступным агенту.
08 / Компьютер и браузер
Управление приложениями требует отдельного инструмента
Чтобы агент мог открывать программы, читать экран или нажимать элементы, нужен инструмент управления компьютером. В расширениях доступен Computer Controller; его включение и системные разрешения выполняются отдельно от подключения ключа GenosAI.
На Mac таким инструментам могут понадобиться «Универсальный доступ» и «Запись экрана» в системных настройках конфиденциальности. Предоставляйте только разрешения, нужные для выбранного действия. Системные запросы доступа и ввод паролей подтверждайте самостоятельно.
В текущей beta на Mac проверен запрос сведений о разрешениях через этот инструмент. Полная приёмка действий по экрану ещё не завершена. Для Windows управление компьютером также не подтверждено. Поэтому универсальную замену Cowork с гарантированными кликами по любым приложениям эта сборка пока не обещает.
Для примера с игрой достаточно вручную открыть файл в браузере. Автоматическое открытие браузера можно пробовать после включения подходящего инструмента и проверки его возможностей в вашей системе. Инструменты конкретного сервиса по MCP часто удобнее, чем действия по экрану.
09 / Контекст
Дайте агенту правила проекта
Если вы повторяете одни и те же требования, сохраните их в инструкции проекта. По умолчанию агент ищет AGENTS.md и .goosehints. Второе имя сохранено для совместимости формата; само приложение называется GenosAI.
В рабочей папке создайте AGENTS.md с краткими правилами: цель проекта, язык ответов, структура папок, команды проверки и ограничения.
Для .goosehints можно использовать настройку инструкций проекта в разделе чата. Вложенные папки могут содержать более точные правила своей области.
После изменения начните новый сеанс, чтобы агент получил обновлённый контекст с начала работы.
Поддерживайте инструкции в актуальном состоянии. Не записывайте туда ключи, пароли и платёжные данные.
Отвечай по-русски. Сначала изучи существующий проект. Исходники сохраняй в src, результаты — в outputs. Не удаляй материалы пользователя без согласования. После изменений выполняй проверки проекта и объясняй результат. Выдавай ссылки на созданные файлы.
Короткие и конкретные правила полезнее большой неупорядоченной инструкции. Контекст расходует токены. Подробное описание архитектуры можно вынести в документ и указать агенту, когда его читать.
10 / Повторяемые задачи
Сохраните сценарий в рецепт
Рецепт — шаблон сеанса с инструкциями и параметрами. Он подходит для повторяемой подготовки отчёта, проверки проекта или создания материалов по одной схеме.
Откройте раздел рецептов и создайте новый рецепт.
Укажите название, описание, исходные инструкции и запрос. При необходимости добавьте параметры, которые нужно заполнять при запуске.
Выберите нужные инструменты и настройки модели, если они предусмотрены формой рецепта.
Сохраните рецепт и запустите его для новой задачи.
Проверьте результат на небольшом примере и скорректируйте инструкцию.
Например: «Подготовка коммерческого предложения» с параметрами «Клиент», «Услуга» и «Исходные данные». Рецепт задаёт процесс, но не даёт дополнительных прав аккаунту и не заменяет необходимые программы, зависимости или подключённые серверы.
11 / Настройки
Язык, доступ инструментов и расходы
Язык. В новых профилях Mac и Windows выбран русский, независимо от языка ОС. Если профиль уже существует и вы выбирали другой язык, измените язык в настройках вручную. Обновление сохраняет прежний выбор.
Инструменты. Проверяйте включённые расширения и режим подтверждения действий перед работой с файлами и внешними сервисами. Для простого разговора локальный доступ не обязателен; для создания проекта он нужен.
Стоимость. Загрузка beta бесплатна. Запросы к моделям оплачиваются с баланса GenosAI. В стоимость текста входит переданный контекст: инструкции, история, файлы, ответы инструментов и ответ модели. Одна агентская задача может включать несколько запросов.
Аккаунт. Проверяйте имя владельца ключа под настройками GenosAI. Отдельный ключ для рабочего приложения помогает разделять доступы. Права и баланс меняются в аккаунте сервиса.
Обновления. Модели обновляются из API. Приложение начиная с beta.10 обновляется через раздел «Версия и обновления» в настройках. Для beta.9 и старше нужен один ручной переход с нашей страницы скачивания. Порядок обновления.
Данные. История и рабочие файлы хранятся на компьютере. При запросе облачной модели нужные для задачи данные передаются сервису. Внешний MCP-сервер получает данные, необходимые его инструментам. Это не полностью офлайн-приложение.
Версия / Обновление приложения
Обновляйте приложение из настроек
Начиная с 0.2.0-beta.10 в настройках есть раздел «Версия и обновления». Он показывает установленную версию и проверяет подписанный каталог SOULCODE. Проверка не использует ключ GenosAI и не расходует кредиты.
Откройте «Настройки» → «Приложение» → «Версия и обновления».
Нажмите «Проверить обновления». Если доступен новый выпуск, прочитайте список изменений и нажмите «Загрузить обновление». Прогресс виден в этом же разделе.
После проверки пакета нажмите «Обновить и перезапустить». Текущая задача должна завершиться: во время работы чата установка блокируется.
Приложение закрывается, сохраняет предыдущую копию, заменяет свои файлы и запускается снова. Ключ, история и папки проектов находятся отдельно и сохраняются.
В версиях beta.9 и старше этого механизма нет: один раз скачайте свежую сборку со страницы SOULCODE. Затем следующие обновления можно получать из приложения. Новые модели и публичные агенты по-прежнему появляются из API без обновления программы.
Устанавливается полный пакет для вашей системы — macOS Apple Silicon или Windows x64. Для Mac приложение нужно перенести из DMG в «Программы», а не запускать постоянно с образа диска. Нужны права записи в папку программы и свободное место для распаковки и резервной копии.
Эта beta не имеет публичной подписи Developer ID/Authenticode. ОС может запросить разрешение, а macOS — снова запросить доступ к ключнице после изменения подписи приложения. Такие запросы подтверждайте самостоятельно; защиту компьютера отключать не нужно.
Версионирование — SemVer: 0.2.0-beta.10 → beta.11 → beta.12. Стабильные выпуски будут без суффикса beta. Пакет для опубликованной версии не меняется; для исправления выпускается новая версия. При ошибке проверки или установки текущая программа не заменяется.
12 / Если что-то не работает
Проверьте причину до повторного запроса
Ключ сохранён, но модели не отвечают
Проверьте интернет, действительность ключа, его права и достаточный баланс. Откройте раздел GenosAI, обновите модели и попробуйте короткий новый чат. Если показывается ошибка доступа, исправьте права ключа в аккаунте. Не вставляйте ключ в обычное сообщение модели.
Приложение пишет, что GenosAI не установлен
Встроенный сервис не требует отдельной установки. Убедитесь, что используете beta.8 или более новую сборку и успешно сохранили ключ. Проверьте включение встроенного GenosAI-подключения. В новом сообщении поясните: «Используй встроенные инструменты GenosAI, сначала получи каталог моделей». Если инструмент отключён в этом сеансе, включите его. Не устанавливайте выдуманный плагин по совету модели.
Не появляется имя аккаунта
Нажмите «Обновить аккаунт». Ключу нужно право read:balance. Если имя отсутствует в самом профиле, приложение может показать email. Сообщение об ошибке загрузки имени не означает автоматически, что весь ключ не работает: другие права проверяются отдельно.
Нет новой модели в списке
Нажмите «Обновить модели» и проверьте, опубликована ли она именно в API GenosAI и в выбранной категории. Наличие названия на другом сайте не гарантирует доступность в нашем каталоге. Новый протокол модели может требовать поддержки в клиенте.
Не найден PDF или презентация
Проверьте существование файла в рабочей папке, правильность папки сеанса и отсутствие перемещения файла. Попросите агента перечислить созданные файлы и выдать актуальную ссылку. Если файл есть, но нет приложения для открытия, установите совместимый просмотрщик или редактор. Для проверки откройте тот же файл из папки вручную.
Агент пишет код, но не сохраняет и не запускает его
Выберите рабочую папку, включите Developer и проверьте режим разрешений. Уточните: «Создай реальные файлы в выбранной папке и выполни проверки». Для запуска Python или Node.js нужны установленная среда и зависимости. Модель без поддержки инструментов не сможет выполнить такую работу через агентский интерфейс.
MCP-сервер не подключается
Проверьте правильный тип транспорта, команду и аргументы либо адрес сервера. Для stdio убедитесь, что команда доступна на компьютере и установлены зависимости. Для удалённого сервера проверьте доступность адреса и авторизацию. Сверяйтесь с документацией конкретного сервера.
Генерация изображения или видео зависла
Проверьте историю и статус задачи. Сохраните идентификатор, если он уже выдан. Не создавайте тот же запрос повторно, пока не выясните состояние предыдущего: облачная генерация может продолжаться и быть оплачена.
После запуска долго нет основного окна
Проверьте, не ожидает ли macOS вашего подтверждения доступа к Связке ключей. Подтвердите системный запрос самостоятельно. Если активной генерации нет, завершите приложение и запустите снова. В beta.9 исправлено преждевременное завершение при закрытии стартового окна. Ожидание системного доступа к ключу исправление не отменяет. Если ошибка повторяется после подтверждения доступа, сохраните сведения для диагностики.
После обновления остался английский язык
Обновление сохраняет настройки старого профиля. Откройте настройки интерфейса, выберите «Русский» вместо «Системный» или «English». По умолчанию русский задаётся для новых профилей обеих платформ.
13 / Диагностика
Соберите сведения об ошибке
Запишите версию приложения, ОС, модель и включённые инструменты.
Скопируйте точный текст ошибки и краткие шаги её воспроизведения.
Если в сеансе доступно окно сообщения о проблеме, скачайте диагностический JSON-отчёт.
Просмотрите отчёт: он может содержать сообщения чата, журналы и сведения о конфигурации. Перед передачей уберите секреты и лишние личные данные.
Свяжитесь с командой SOULCODE через контакты на сайте. Приложите только проверенные сведения, необходимые для воспроизведения.
Не отправляйте API-ключ, пароль или системную Связку ключей. Если проблема связана с оплатой или правами GenosAI, обратитесь также в поддержку самого сервиса. Полный диагностический отчёт и короткое описание ошибки — разные документы; перед отправкой проверяйте каждый.
14 / Продолжение работы
Доработайте первый результат
Продолжите чат и улучшите созданную игру: добавьте дизайн, адаптацию к телефону или сохранение счёта. Затем попробуйте свой рабочий проект, задайте инструкции папки и подключите нужный MCP-сервис.
Перед большой задачей начинайте с небольшого проверяемого результата. Просите агента сохранять исходники, проверять сделанное и объяснять ограничения. Проверяйте итоговые документы, код и расходы — модель может ошибаться.
Обновлено 12 октября 2026. Это русскоязычное руководство нашей сборки GenosAI Desktop: полный сценарий быстрого старта адаптирован к фактическим установщикам и возможностям продукта. Лицензии и уведомления исходного проекта сохраняются в дистрибутиве.