Документация YappiX AI

Что такое YappiX AI

YappiX AI — приложение для Mac, Windows и Linux, где вы объясняете задачу словами, а ИИ-агент делает сайт, дизайн, презентацию или картинку: пишет код, запускает проект, показывает результат рядом с чатом и сам проверяет его глазами, прежде чем отдать.

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

• Новая беседа начинается с плиток: сайт или сервис, дизайн, презентация, картинка, проверка сайта.
• Проект — это папка; внутри сколько угодно бесед. У каждого проекта свой предпросмотр и свой терминал.
• Предпросмотр рядом с чатом: можно показать мышкой, что поправить, и отправить в чат снимок экрана.
• Документы по ссылке: агент читает файлы с Яндекс Диска и Google, а Яндекс Диск можно подключить целиком.
• Коннекторы к Figma, GitHub, Linear, Notion и другим сервисам — одной кнопкой.
• Ключи и токены проекта лежат в защищённом хранилище системы, а не в переписке с моделью.
• Интерфейс, меню, справка и сам агент — на русском; учётная запись и память хранятся в России, запросы к моделям идут через наш шлюз.

Что нужно от компьютера

Скачать и установить

Регистрация и вход

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

1. 1Запустите YappiX AI: откроется окно входа с вкладкой «Регистрация».
2. 2Укажите имя, почту и пароль (не короче 8 символов) и нажмите «Создать учётную запись». Нажимая, вы принимаете лицензионное соглашение и политику конфиденциальности — ссылки под кнопкой.
3. 3На почту придёт письмо. Откройте его и нажмите «Подтвердить почту». Окно программы само заметит подтверждение и продолжит вход — закрывать его не нужно.
4. 4Готово: бесплатный тариф включён, карта не нужна, ключ доступа к моделям программа получит сама.

Уже есть учётная запись yappix.ru — откройте вкладку «Вход» и введите ту же почту и пароль: тариф и лимиты подтянутся сами.

Как разговаривать с агентом

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

• Правки показываются как изменения в файлах: видно, что добавилось и что убралось.
• Команды агент запускает сам и читает их вывод: если сборка упала, он видит ошибку и чинит.
• Пока агент работает, можно писать: сообщение дополнит текущую работу или встанет в очередь.
• Если приложение закрылось посреди беседы, после запуска она на месте — можно продолжить.
• Показать мышкой: в предпросмотре нажмите указатель и щёлкните по кнопке, заголовку или блоку — он появится в чате, останется написать, что поправить.
• Кольцо рядом с полем ввода показывает, насколько занято окно контекста модели.
• Команды в поле ввода начинаются с «/»: они подсказывают, что умеет агент.
• Меню «Авто» рядом с полем ввода выбирает мощность: «Авто» — студия подбирает модель под шаг сама (новое — ведущей моделью, правки — классом ниже), «Быстрая», «Умная», «Максимальная» — уровень на весь ход, или конкретная модель из тех, что открывает тариф.

Беседа с сайта

На yappix.studio можно начать без установки: описать задачу агенту, выбрать готовое решение, стиль и технологии и посмотреть живое превью. «Собрать в YappiX AI» переносит беседу в программу.

• Нажали «Собрать в YappiX AI» на сайте — установленная программа открывается сама и забирает беседу: проект с вашей задачей, текстами и выбором. Вошли на сайте той же учётной записью, что в программе, — даже если браузер не открыл ссылку, запущенная программа находит беседу сама: сразу при возврате в её окно или не позже чем через 15 секунд.
• Не вошли на сайте или программа на другом компьютере — сайт кладёт код из шести знаков в буфер обмена, программа подхватит его, как только вы вернётесь в её окно. Не вышло — на стартовом экране «Беседа с сайта не открылась? Ввести код»: вставьте код или ссылку yappix://import/….
• Программа заводит проект, кладёт выбранное решение с текстами под ваше дело и показывает согласование — выбор с сайта уже отмечен. Свой макет Figma, указанный на сайте, попадает в «Образцы».
• Ненужную беседу уберите крестиком на карточке; код одноразовый, беседы с сайта ждут неделю.

Проекты и беседы

Проект — это папка на вашем компьютере. Внутри проекта сколько угодно бесед, и каждая помнит свою историю. Список проектов слева стоит по алфавиту и не прыгает при выборе.

• Новый проект — папка в ~/YappiX, названная по первой задаче. Заводить её заранее не нужно.
• Открыть папку — работать в уже существующей папке со своим сайтом.
• Правый щелчок по проекту, беседе или файлу открывает меню: добавить в чат, показать в Finder или проводнике, открыть в терминале, в VS Code, Cursor и других программах.
• Убрать проект из списка можно в его меню: папка и беседы на диске остаются.
• Удалить проект целиком — «Удалить проект…» в его меню: окно перечислит, что пропадёт, и попросит ввести имя проекта (подробно — в разделе «Контроль версий и удаление проекта»).
• Беседа, в которой агент сейчас работает, помечена в списке: можно перейти в другую беседу и вернуться — работа не прервётся.

Контроль версий и удаление проекта

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

• Сохранить вручную — «Сохранить сейчас», подпись можно не писать.
• Посмотреть изменения — нажмите на версию: появятся файлы, а по щелчку на файл — строки, что добавились и что ушли.
• Вернуть версию — «Вернуть эту версию». Текущее состояние сначала сохраняется само, поэтому вернуться обратно можно так же.
• Ключи (.env) и тяжёлые папки (node_modules, сборки) в историю не попадают.

Предпросмотр, снимки и PDF

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

• Указатель — выбрать элемент страницы: он попадёт в чат с описанием, и можно писать «сделай этот блок крупнее».
• Камера — снимок экрана: сохраняется страница, на которой вы сейчас, с той же прокруткой, в размере окна или телефона. Снимок сразу прикрепляется к сообщению; убрать его можно крестиком.
• Компьютер, планшет, телефон — как страница выглядит на разных экранах.
• PDF — кнопка в панели предпросмотра у презентации: каждый слайд становится страницей, файл ложится рядом с презентацией. Когда презентация готова, PDF создаётся сам.

Если предпросмотр упал, приложение перезапустит сервер само. Не помогло — причина уйдёт агенту в чат вместе с журналом запуска, и он её исправит. Вам ничего разбирать не нужно.

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

Режим дизайна

Кнопка с карандашом над предпросмотром включает режим дизайна: правки прямо на странице, без описаний словами.

• Текст. Щёлкните по заголовку, кнопке или абзацу и поправьте его на месте. Если такой текст встречается в коде один раз, студия меняет его сама — без агента и без расхода токенов, страница обновится сразу. Если текст повторяется или в нём кавычки и скобки, правку получит агент.
• Метки. Щёлкните по элементу и напишите пожелание — «кнопку крупнее», «сюда маску телефона». Меток можно поставить сколько угодно; «Отправить метки» передаёт их агенту одной репликой с указанием, где каждый элемент.
• «В чат» — элемент уходит в поле ввода, как при «Выделить элемент».

Терминал и сервер

У каждого проекта свой терминал, открытый в его папке. Кнопка «+» открывает ещё один.

Вкладка «Сервер» показывает журнал сервера предпросмотра вживую, порт и номер процесса. Кнопки «Перезапустить» и «Остановить» управляют им. Если в своём терминале вы запустите npm run dev и увидите «Another next dev server is already running» — это тот же сервер: он виден на вкладке «Сервер».

Презентации и картинки

Презентация открывается во вкладке «Презентации» над предпросмотром и обновляется на глазах, пока агент её пишет. Листаются слайды колесом мыши, трекпадом, свайпом, стрелками клавиатуры и кнопками ‹ ›. Кнопка «PDF» (или клавиша P) сохраняет файл: каждый слайд — страницей.

Фото в сайтах и презентациях агент ставит сам: снимки под ваше дело генерируются при заказе (около 20 секунд на кадр), лежат в папке проекта public/images и в лимит картинок тарифа не входят. Похожий снимок, уже сделанный для другого заказа, агент может взять из библиотеки YappiX — это быстрее. Хотите свои фото — положите их в проект и скажите агенту, какие заменить.

Вкладка «Картинки» — галерея всех картинок проекта: нажмите, чтобы увидеть крупно, добавить в чат («В чат») или показать в папке. Новая картинка открывается сама. Формат кадра — 16:9, 1:1, 4:3 или 9:16.

Лимиты картинок и презентаций считаются за период тарифа — 30 дней с даты оплаты (у бесплатного — за сутки по Москве) — и зависят от размера тарифа; линейка (Claude, ChatGPT, Grok, «Всё вместе») на них не влияет:

Картинка лучшего качества считается за две. Презентация стоит от 1 до 3 кредитов: быстро — 1 (Claude или GPT-6.1 Sol), с исследованием темы — 3 на Claude и 2 на GPT-6.1 Sol. Кредит тратится только на создание презентации: правки готовой идут на модели тарифа (Claude Sonnet, DeepSeek V4 Pro) и кредитов не стоят. Кончились кредиты — презентация соберётся на модели тарифа, студия скажет об этом. Остатки видны в окне «Учётная запись». Когда лимит кончился, можно докупить пакеты (докупленное не сгорает): 100 картинок — 690 ₽, 400 картинок — 2 490 ₽, 5 кредитов презентаций — 790 ₽, 20 кредитов — 2 490 ₽.

Документы по ссылке

Вставьте в чат ссылку на документ — агент прочитает его сам: техзадание, прайс, договор, презентацию. Работает со ссылками на Яндекс Диск и на Google Документы, Таблицы, Презентации и файлы Google Диска.

• Читаются docx, xlsx, pptx, pdf, txt, csv и страницы HTML. Старые doc и xls пересохраните в новый формат; сканы PDF без текста пока не распознаются.
• У файла должен быть общий доступ: на Яндекс Диске — «Поделиться по ссылке», в Google — «Все, у кого есть ссылка» (просмотр). Закрытый документ агент прочитать не сможет и скажет об этом.
• Если по ссылке папка, агент покажет её содержимое и прочитает нужные файлы. Google Диск читается через сервер YappiX — файлы не сохраняются.
• Картинки, логотипы и шрифты агент может скопировать с Диска прямо в проект.

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

Коннекторы

Коннекторы подключают агента к сервисам: макеты Figma, задачи Linear, документы Notion, код на GitHub, документация библиотек, браузер, Next.js, shadcn/ui, Expo и другие. Включаются кнопкой «Коннекторы» слева или через меню.

• Токены вводятся в защищённом окне приложения, а не в чат: переписка уходит модели, токен — нет.
• Токены хранятся в связке ключей системы. Модель их не видит.
• Figma подключается по личному токену (любой тариф Figma); если на компьютере открыта настольная Figma с включённым сервером MCP, данные берутся из неё. Ссылку на макет агент читает, когда работает над дизайном и страницами.
• Любое подключение можно отключить или удалить в любой момент.
• Flowbite и Ant Design — официальные серверы компонентов и тем. Отдельно включать не обязательно: выбрали такую дизайн-систему на согласовании — студия подключит её сервер сама на время задачи (для Mantine и Untitled UI — документацию Context7).

Ключи и память проекта

Вкладка «Ключи» (вверху справа) показывает ключи и токены проекта: какие заданы, каких не хватает и где они лежат. Список берётся из файлов .env проекта; чего нет в них, но есть в .env.example, помечено «не задана».

• Добавить, изменить и удалить ключ можно прямо во вкладке. Значение записывается в .env (доступ только вам) и копией — в связку ключей системы.
• Значения скрыты: глаз показывает ключ на 20 секунд, «Копировать» кладёт его в буфер обмена. В чат и модели значения не попадают: агент видит только имена и не просит заново то, что уже задано.
• Потеряли .env — вкладка покажет «есть только в связке ключей» и вернёт ключ одной кнопкой.
• Если файл с ключами не закрыт в .gitignore или уже попал в git, вкладка предупредит и поможет закрыть.
• Секреты, случайно вставленные в чат, заменяются пометкой «скрыто» до отправки модели.

Решения, правила и дизайн, которые агент записал в папку .yappix проекта, учитываются в каждой следующей задаче («память проекта»). Они перечислены внизу вкладки «Ключи»: нажмите на файл, чтобы открыть и поправить.

Как опубликовать готовый сайт

Когда в проекте появился сайт, в верхней панели студии появляется кнопка «Опубликовать». Сайт выкладывается на поддомен имя.app.yappix.ru с сертификатом — открывается сразу по https — или на ваш домен: студия проверит, что домен смотрит на сервер, и выпустит сертификат. Опубликованный сайт можно обновить, открыть или снять с публикации; кнопка показывает «В сети».

Сайту нужна база — заявки, корзина, вход? В том же окне «Подключить базу данных»: PostgreSQL на серверах платформы, строка подключения ложится в ключи проекта. Можно и словами в чате: «опубликуй» — агент проверит сборку и опубликует сам.

На свой сервер — «На свой сервер по SSH»: вход по ключу, без пароля. Готовый сайт выкладывается файлами, прежняя версия остаётся рядом; приложение (Next.js и т.п.) собирается на сервере и запускается через pm2.

Результат работы — по-прежнему обычная папка проекта на вашем компьютере: её можно собрать npm run build и выложить на любой хостинг.

Тарифы, лимиты и докупка

Тариф — это линейка и размер. Линейка решает, какие семейства моделей открыты: «Claude» — Claude и открытые модели (Kimi, DeepSeek, GLM), «ChatGPT» — модели OpenAI и открытые, «Grok» — Grok для кода и открытые, «Всё вместе» — Claude и GPT вместе с открытыми. Размер — Старт, Pro или Expert — задаёт объём работы моделей на период (у бесплатного — на сутки), месячные лимиты картинок и презентаций и число проектов на серверах платформы. Расход виден в чате и в окне «Учётная запись»: сколько потрачено, сколько осталось по каждому семейству моделей.

Лимиты считаются как у Claude и ChatGPT: у каждого семейства моделей свой счётчик — окно 5 часов и неделя (шесть окон). Сообщение — обращение к опорной модели семейства с контекстом проекта (около 12 тысяч токенов на входе, большая часть из кэша, и тысяча на выходе); дорогие модели расходуют лимит быстрее — Opus как два сообщения Sonnet, Fable как пять. Быстрые модели расходуют те же деньги в десятки раз медленнее, правки идут на моделях классом ниже, поэтому реальных сообщений больше. Исчерпано окно или неделя одного семейства — студия продолжает на моделях остальных семейств тарифа (сначала сильных, потом открытых) и пишет, когда лимит обновится; исчерпаны все — остаётся дождаться обновления или взять тариф больше. Счётчики — в «Учётной записи».

• Бесплатный тариф: 20 быстрых сообщений за 5 часов (до двух окон в сутки), 5 сообщений DeepSeek V4 Pro в сутки и 3 картинки в сутки, без карты.
• Платные тарифы — линейка и размер, за 30 дней. «Claude» — Старт 2 190 ₽, Pro 3 990 ₽, Expert 11 990 ₽; «ChatGPT» — 1 990, 3 790 и 10 990 ₽; «Grok» — 2 190, 3 990 и 11 990 ₽; «Всё вместе» — 3 490, 6 490 и 19 990 ₽. Топовые модели (Claude Fable, GPT-5.5, GPT-6 Astra) открыты на Expert. «Пробный Pro» — 7 дней бесплатно (Pro линейки «Всё вместе»), один раз на учётную запись.
• Подписчики, оплатившие тариф до 22 октября 2026 года, остаются на прежних условиях и цене до продления. Перейти на линейку можно в любой момент: дешевле — со следующего периода, дороже — сразу оплатой.
• Оплата картой российского банка или через СБП на защищённой странице платёжного сервиса; чек приходит на почту. Подписку можно сменить или отменить в личном кабинете.
• Окно «Учётная запись» (клик по имени внизу слева или Ctrl+, — на Mac ⌘,) показывает тариф и счётчики по каждому семейству моделей, остатки, докупку пакетов, смену пароля и выход. Кнопка «Сменить тариф» открывает выбор линейки и размера с ценами и лимитами: оплата — сразу, переход на тариф дешевле — со следующего периода.
• Возврат за неиспользованное время считается пропорционально оставшимся дням, но не больше стоимости неизрасходованного объёма: правила — yappix.ru/yappix-ai/vozvrat.

Как программа обновляется

Агент встроен в приложение, поэтому обновляется всё вместе — новой сборкой. С версии 2.0.3 ставить её вручную не нужно.

1. 1При запуске программа проверяет, не вышла ли новая версия; проверить сразу можно в меню YappiX AI → «О программе» → «Проверить обновления».
2. 2Если версия новее — нажмите «Обновить и перезапустить». Приложение скачает сборку с сервера YappiX, проверит её подпись и установит; на Windows установщик пройдёт тихо, на macOS приложение заменится в «Программах».
3. 3Программа перезапустится сама. Проекты, беседы, ключи и настройки остаются на месте.
4. 4Если обновить изнутри не получилось (например, пакет deb на Linux, который ставится через apt), рядом есть кнопка «Скачать» — новая сборка откроется в браузере.

Сторонние компоненты и лицензии

Агент собирает страницы из каталога блоков YappiX: часть блоков — наша разработка, часть переработана нами из открытых библиотек. Мы берём только то, что авторы разрешают использовать в конструкторах сайтов, указываем авторство и прикладываем тексты лицензий. Переработка — наша: блоки переведены на токены темы, тексты — на русский, добавлены проверки на телефоне и в тёмной теме.

• В проекте у каждого блока из открытой библиотеки в начале файла указаны источник, лицензия и пометка «переработано YappiX».
• Полные тексты лицензий и список авторов — в файле THIRD_PARTY_NOTICES.md в корне проекта: агент дописывает его, когда ставит такой блок. Не удаляйте этот файл — его требуют лицензии.
• Картинки из открытых библиотек в блоки не переносятся: фото для блоков агент берёт из библиотеки YappiX или генерирует под ваш заказ, а вы можете заменить их своими.

Если что-то пошло не так

Если ничего не помогло, напишите на support@yappix.studio и приложите, что было на экране. Так быстрее всего.

Оценка, поддержка и форум

• «Оценить» — в правом нижнем углу программы: звёзды, отзыв, идея, баг или вопрос. Сообщение сразу видит команда, рядом с вашей учётной записью.
• «Поддержка» — кнопка над «Коннекторами»: выберите, что случилось, опишите — тема откроется на форуме forum.yappix.studio с версией программы и системой. Можно и письмом на support@yappix.studio.
• На форум программа пускает сразу вошедшим — той же учётной записью, без пароля. С сайта — кнопка «Войти» на форуме ведёт в кабинет YappiX.
• Не публикуйте на форуме ключи, пароли, содержимое .env и персональные данные: форум открытый. Вопросы об оплате — на почту.

Горячие клавиши

На Mac вместо Ctrl используется ⌘.

Что будет дальше

Ближайшие возможности, над которыми идёт работа. Без обещаний по датам: выкладываем, когда доведём до рабочего состояния.