Ваш продукт.
На Python.
С YETI³.

От установки до первого запуска.

Понадобятся Python 3.12 или новее и интернет. Создайте папку проекта и откройте в ней терминал. Терминал — окно, в котором запускают команды.

python3 --version
python3 -m venv .venv-sdk
source .venv-sdk/bin/activate

python -m pip install -r https://engine.yeti3.ru/sdk/latest/requirements.txt

python -c "from pathlib import Path; from urllib.request import urlopen; p=Path('hello.py'); p.exists() and exit('hello.py уже существует: сохраните его или используйте другую папку'); p.write_bytes(urlopen('https://engine.yeti3.ru/sdk/examples/hello.py').read())"
python hello.py

Небольшой код. Полный цикл.

Готовый файл: скачать hello.py. Модуль — часть приложения с собственным именем и поведением при запуске.

from yeti3_core import Engine, Module, ModuleManifest

class HelloModule(Module):
    manifest = ModuleManifest(
        id="hello", name="Первый модуль", version="1.0.0"
    )

    def boot(self, engine: Engine) -> None:
        print("Привет! Модуль YETI3 запущен.")

engine = Engine()
engine.register(HelloModule())
engine.boot()
engine.shutdown()

Следующий шаг: измените текст приветствия и запустите файл снова. Затем добавьте второй модуль с другим id и зарегистрируйте его перед engine.boot().

От примера к своей мастерской.

Модуль заявок, сборка решения, HTML-шаблон и ассет-пак в одном работающем проекте. Создавайте заявки, меняйте статусы и сохраняйте результат в SQLite.

Модули, решения,
языки и темы.

Одна команда устанавливает весь SDK и его Python-зависимости. Нужен Python 3.12 или новее и активированное виртуальное окружение из быстрого старта.

python -m pip install --index-url https://engine.yeti3.ru/sdk/simple/ yeti3-engine==0.4.3
python -m pip check

Попробовать языки и темы

Скопируйте команды целиком. Последняя создаёт файл theme.css в текущей папке: подключите его в шаблоне своего сайта.

python -c "from yeti3_languages import Translator; print(Translator('ru')('install.success', name='Магазин'))"
python -c "from yeti3_languages import Translator; print(Translator('en')('action.install'))"
python -c "from pathlib import Path; from yeti3_themes import theme; Path('theme.css').write_text(theme('light').css(), encoding='utf-8')"

Ожидаемый вывод первых двух команд: Пакет Магазин установлен и Install. Для тёмной темы замените light на dark. Неизвестный язык, ключ или имя темы вызывают понятную ошибку, а не незаметную подмену перевода.

Готовая страница за минуту

Пример регистрирует модуль в ядре, выбирает язык и создаёт страницу с темой. После установки полного SDK выполните:

python -c "from urllib.request import urlretrieve; urlretrieve('https://engine.yeti3.ru/sdk/examples/extensions.py', 'extensions.py')"
python extensions.py --output sdk-demo --language ru --theme light
python -m http.server 8080 --bind 127.0.0.1 --directory sdk-demo

Откройте http://127.0.0.1:8080/. Появится «Мой проект». Для английского языка и тёмной темы используйте --output sdk-demo-en --language en --theme dark. Сервер останавливается сочетанием Ctrl+C. Пример создаёт новую страницу и отказывается перезаписывать существующую.

Автоматическая установка на сайт

1. В кабинете выберите сайт с действующей лицензией и подключённым агентом установки.
2. Выберите опубликованный пакет. Сервер проверит версию, зависимости, совместимость и готовность сайта.
3. Нажмите «Установить». Для платного пакета сумма резервируется на балансе проекта.
4. Агент установит пакет и зависимости, выполнит миграции, пересборку статики и проверки.
5. После подтверждённого успеха резерв превращается в оплату. Подтверждённая ошибка освобождает резерв. Повторный запрос не списывает средства ещё раз.

Локальная разработка

yeti3_modules.install(distribution, installer) и yeti3_solutions.install(distribution, installer) активируют уже установленные Python-дистрибутивы с точкой входа yeti3.packages. Передайте свой постоянный ModuleInstaller с адаптерами сайта. Зависимости Python объявляйте в pyproject.toml, зависимости модулей — в manifest. Локальный API не проводит платежи и не заменяет лицензированную доставку из каталога.

Установка SDK через pip добавляет библиотеки в окружение. Она не запускает ваш сайт и не списывает средства.

Понятные границы с первого дня.

Имя для установки содержит дефис: yeti3-core. Имя для импорта — подчёркивание: yeti3_core. Существующие импорты yeti3.* продолжают работать при установке соответствующего пакета.

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

Что установится вместе с пакетом

Три канала: latest, dev, night

Выберите канал один раз. Его requirements-файл установит весь SDK и совместимые зависимости. Для смены канала создайте отдельное виртуальное окружение.

# Стабильный SDK — для рабочего проекта
python -m pip install -r https://engine.yeti3.ru/sdk/latest/requirements.txt

# Текущая разработка — отдельное тестовое окружение
python -m pip install -r https://engine.yeti3.ru/sdk/dev/requirements.txt

# Канал ночных проверочных сборок — отдельное тестовое окружение
python -m pip install -r https://engine.yeti3.ru/sdk/night/requirements.txt

latest — имя канала, а не номер Python-пакета. Точные версии и SHA-256 доступны в requirements.lock рядом с requirements.txt. Для сохранения выбранной сборки скачайте этот lock-файл в проект; повторная установка по сохранённому файлу использует те же версии. Наличие канала night само по себе не означает настроенное ежедневное расписание сборок.

Переход с версии 0.2.0

Начиная с 0.3.0 изменились владельцы файлов между пакетами. Создайте новое виртуальное окружение по инструкции выше и установите нужные пакеты версии 0.4.3. Прямое обновление старого окружения через pip install -U не поддерживается: удаление старого engine может удалить файлы новых пакетов. Старое окружение сохраните для возврата к предыдущей версии.

Подключение дополнительных пакетов

python -m pip install -r https://engine.yeti3.ru/sdk/latest/requirements.txt

Установка Python-пакета добавляет код в окружение. Активация модуля, миграции, права на решение и настройка сервисов — отдельные шаги. Для промышленной установки см. протокол доставки и жизненный цикл.

Правило для новых packages

Один пакет — одна понятная ответственность, собственный pyproject.toml, явные зависимости, публичные импорты, запускаемый пример и описание ошибок. Новые направления, например yeti3-telemetry или yeti3-django, выделяются только вместе с рабочей реализацией и проверкой установки.

Поддержка проекта через донаты.

Учёт сборов по сайтам, ЮKassa и Альфа-Банк, защита от повторного зачисления.

Подключить донаты · Проверка ресурсов в SDK 0.4.4

Два Telegram-бота. Один SDK.

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

Подключить Telegram-ботов

Создать. Проверить. Запустить.

Одна команда создаёт проект, устанавливает совместимые зависимости и фиксирует версии. Готовые сценарии: базовый проект и Mobile GPU.

Начать с готового сценария

Mobile GPU · WebGPU

Подключите браузер устройства к очереди численных заданий через модуль SDK. Одноразовый код, согласие владельца устройства, проверка результата.

Установка, пример и ограничения

Ответы рядом с кодом.