Документация 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Бесплатный тариф включается сразу, без карты.

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

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

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

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

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

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

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 — программа сделает это той же кнопкой, только укажет другой адрес назначения.

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

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

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

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

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

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

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

Сама среда меняется редко. Когда меняется, программа предложит скачать новый установщик — проекты, ключи и настройки при этом остаются на месте. Проверить обновления вручную можно командой «YappiX: Проверить обновления».

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

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

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

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