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

Что такое YappiX AI

Это программа для компьютера, в которой вы объясняете словами, что нужно сделать, а ИИ-агент пишет код, запускает его и показывает результат. Внутри полноценная среда разработки: файлы проекта, терминал, история изменений. Но работать с ней можно, ничего не зная про код.

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

• Интерфейс, агент и подсказки на русском языке.
• Модели и данные проходят через инфраструктуру в России.
• Проект можно опубликовать в один шаг на наших серверах или увезти на свой.
• Код остаётся у вас: папка с файлами, которую можно открыть в любой другой программе.

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

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

Проверка системы и Node.js

При первом запуске программа смотрит, всё ли на месте, и показывает список. Если всё в порядке, окно не появляется вовсе. Проверку можно вызвать в любой момент: «Вид» → «Палитра команд» → «YappiX: Проверка системы».

• Node.js — среда, в которой работают сайты и приложения.
• npm — менеджер пакетов, ставит библиотеки проекта.
• Git — хранит историю изменений проекта. В Windows программа ставит его сама.
• Связь с платформой — доступ к моделям и публикации.
• Учётная запись — ключ доступа к моделям.
• Папка проекта — в какой папке работает агент.
• Место на диске — библиотеки занимают несколько гигабайт.
• Локальная модель — если у вас установлена Ollama, проверка покажет, запущена ли она.

Напротив каждой строчки, где чего-то не хватает, есть кнопка. Node.js программа ставит сама: скачивает официальный установщик с nodejs.org, сверяет контрольную сумму и открывает его. В Linux установщика не существует, поэтому официальный архив распаковывается в папку программы — права администратора не нужны.

Учётная запись и тариф

1. 1Нажмите «Войти» в панели агента и заведите учётную запись по почте.
2. 2Подтвердите почту письмом — оно приходит в течение минуты.
3. 3Программа сама получит ключ доступа к моделям, вводить его руками не нужно.
4. 4Бесплатный тариф включается сразу, без карты. Тариф «Pro» можно попробовать 7 дней без оплаты и без карты — кнопка в его карточке; пробный период даётся один раз.

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

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

Всё то же самое есть и на сайте — yappix.ru/kabinet, вход той же почтой и паролем. Там видно привязанные компьютеры, продление тарифа и запомненную карту; там же учётную запись можно удалить. Кабинет пригодится, когда до программы не добраться: например, оба компьютера заняты, а войти нужно на третьем.

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

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

Вопросы о вашем деле — что считать заказом, какие статусы, нужна ли оплата — агент задаёт в начале одной карточкой. У каждого вопроса своё поле, а серым написано, что он сделает, если ответа не будет. Можно ответить на часть и нажать «Отправить», можно «Оставить как предложено». Работа ответов не ждёт: ответите позже — он уточнит уже готовый проект.

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

Предпросмотр: посмотреть, что получилось

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

1. 1Программа находит команду запуска в проекте: dev, start или serve.
2. 2Если библиотеки ещё не установлены, сначала выполняется установка — на большом проекте это несколько минут.
3. 3Когда сервер поднимается, страница открывается сама.
4. 4Вывод виден в терминале внизу: если там ошибка, напишите агенту «исправь ошибку запуска».

Что происходит, когда вы нажимаете «Опубликовать»

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

1. 1Программа определяет тип проекта: обычный сайт из готовых файлов или приложение, которое нужно запускать.
2. 2Проверяет файлы на битую кодировку — сборщики на таких файлах падают с невнятной ошибкой, дешевле поймать заранее.
3. 3Собирает проект и упаковывает в архив, исключая служебные папки вроде node_modules.
4. 4Архив уходит на сервер платформы и встаёт в очередь публикации.
5. 5На сервере архив распаковывается в отдельную папку вашего сайта.
6. 6Для приложения поднимается изолированный контейнер: в нём ставятся библиотеки проекта командой npm install, затем выполняется сборка npm run build.
7. 7Приложение запускается командой npm run start и получает собственный внутренний порт.
8. 8Платформа ждёт, пока приложение ответит на запрос. Контейнер, который падает по кругу, публикацией не считается.
9. 9Создаётся адрес вида имя.app.yappix.ru и выпускается сертификат, чтобы сайт открывался по https.
10. 10Проверяется, что картинки и стили действительно отдаются: битые ссылки на файлы — частая причина «сайт открылся, но пустой».

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

Свой домен и свой сервер

Сайту можно дать собственный домен: в личном кабинете указываете адрес, платформа проверяет, что домен направлен на неё, и выпускает сертификат. Прежний адрес на app.yappix.ru продолжает работать.

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

Базы данных, история и ключи

• Переписка с агентом хранится на вашем компьютере в зашифрованном виде: ключ лежит в хранилище системы, читать файлы со стороны нельзя.
• База данных создаётся по запросу агента, строка подключения попадает в проект автоматически.
• История изменений хранится в нашем хранилище кода: коммиты видно прямо из строки состояния программы.
• Ключи от сторонних сервисов складываются в хранилище системы, а не в файлы проекта.
• Секреты вырезаются из переписки: ключ не уходит в модель и не попадает в журналы.
• Проект удаляется прямо из списка слева — значок корзины при наведении. Папка уходит в Корзину системы (её можно восстановить), беседы — в архив; по желанию удаляются и хранилище кода с базой данных на платформе.
• Если папку проекта удалили и завели новую с тем же именем, а проект на платформе остался, агент сам выберет новое имя — например, flowers-2 — и продолжит работу.

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

Тариф задаёт лимит работы моделей на период (у бесплатного — на сутки) и число проектов на наших серверах. Расход виден в чате и в кабинете: сколько потрачено и сколько осталось. Если лимит закончился в середине задачи, пакет можно докупить прямо в переписке, не уходя из программы.

• Бесплатный тариф: дневная квота быстрой модели — около 150 тыс. токенов в день, без карты. Проекты на серверах платформы на нём не создаются.
• Платные тарифы — «Старт» 1 990 ₽, «Pro» 5 900 ₽, «Expert» 19 900 ₽ за 30 дней: больше лимит, проекты с базами данных и публикация. «Пробный Pro» — 7 дней бесплатно, один раз на учётную запись.
• Подписку можно сменить или отменить в личном кабинете, чек приходит на почту.

• Автопополнение докупает пакет само, когда оплаченный объём подходит к концу: не чаще раза в шесть часов и не больше десяти пакетов в месяц. Включается и выключается в окне подписки.
• «Забыть карту» в том же окне отзывает согласие на списания целиком: ни продление тарифа, ни автопополнение больше не сработают. Оплатить снова можно в любой момент — карта запомнится заново.
• Отказ от продления выключает и автопополнение: платить дальше не с чего.
• Возврат за неиспользованное время считается пропорционально оставшимся дням, но не больше стоимости неизрасходованного объёма: правила на yappix.ru/yappix-ai/vozvrat.

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

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

1. 1Программа проверяет выпуски раз в сутки и показывает окно, когда есть новое.
2. 2Нажмите «Обновить» — сборка скачается, проверится по контрольной сумме и встанет на место прежней.
3. 3Проекты, ключи, настройки и открытые беседы остаются на месте.
4. 4После установки программа предложит перезапуститься — до перезапуска можно спокойно доработать.

Если обновление важное — например, починили то, из-за чего что-то не работало, — над полем ввода появляется яркая полоса со ссылкой на сборку: на случай, если установку изнутри вы предпочтёте сделать руками. Проверить обновления вручную можно командой «YappiX: Проверить обновления», а посмотреть список изменений — «YappiX: Что нового».

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

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

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

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