ErisPulse ErisPulse
Открыть интерактивную версию →
Разделы страницы
Статическое зеркало — интерактивная версия является основной Открыть интерактивную версию →

ErisPulse-App

Tip

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

ErisPulse-App — это официальный клиент для нескольких платформ, поддерживаемый напрямую ErisDev (доступен для Android / Windows / Linux / macOS),
предоставляющий полностью нативный графический интерфейс управления: создание, запуск и управление несколькими экземплярами роботов на телефоне или компьютере,
без использования терминала и без отдельной установки среды Python.

Important

ErisPulse-App — это независимая программа-клиент, а не модуль, установленный с помощью epsdk install.
Он содержит встроенный интерпретатор Python и ErisPulse SDK, и его можно использовать сразу после установки — на телефоне можно запускать напрямую.

Функциональные возможности

  • Управление несколькими экземплярами: создание/запуск/остановка/удаление нескольких экземпляров, автоматическое распределение портов и токенов доступа, поддержка новых сред или клонирование существующих
  • Панель инструментов: статистика адаптеров/модулей/онлайн-роботов/общего количества событий, изменение цвета индикаторов при превышении использования CPU/памяти
  • Магазин модулей: поиск и фильтрация по тегам, установка/обновление/удаление одним нажатием, установка определённой версии, поддержка pip-реестров и Git-пакетов
  • Поток событий + конструктор событий: просмотр событий в реальном времени, визуальное построение тестовых событий и отправка их адаптеру
  • Мониторинг: объединённый вид логов/жизненного цикла/аудита
  • Управление командами: глобальные настройки префиксов и псевдонимов, включение/отключение и чёрные/белые списки платформ
  • Обзор роботов/конфигурация/управление файлами: прямое управление экземплярами через родной интерфейс
  • Работа в фоновом режиме: фоновый сервис для Android для поддержания активности; Windows минимизируется в системный трей, закрытие окна не прерывает экземпляр
  • Динамическое окно модуля: автоматическое появление страниц, зарегистрированных модулем, в боковом навигационном меню (в той же группе, что и Dashboard), переход по клику

Поддерживаемые платформы

Все установочные пакеты можно скачать на GitHub Releases, выберите нужный по своему усмотрению:

Платформа Установочный пакет Описание
Android online-*.apk / offline-*.apk Запуск непосредственно на телефоне, без компьютера
Windows windows-x64-setup.exe / windows-x64.zip Установочный / портативный вариант
Linux linux-x64.tar.gz Распаковать и использовать
macOS macos-arm64.zip Apple Silicon (arm64)

Один код Flutter-приложения поддерживает все платформы.

Способы установки (Android / запуск напрямую с телефона)

Скачайте APK-файл с GitHub Releases и установите его. Существует два варианта сборки:

Сборка Образ среды выполнения Сценарий использования
erispulse-app-online-*.apk Скачивается при первом запуске Установочный пакет меньше по размеру, подходит для хорошего интернет-соединения
erispulse-app-offline-*.apk Упакован в APK Полностью автономный, после установки не требуется подключение к интернету

Оба варианта имеют одинаковые шаги установки:

  1. Скачайте и установите APK-файл, при запуске разрешите разрешение на уведомления (необходимо для поддержания работы фоновых сервисов)
  2. После появления на главной странице баннера инициализации нажмите "Запустить" для выполнения первой инициализации (с прогресс-баром и логами)
  3. Создайте экземпляр и запустите его
  4. Настройте адаптеры и API-ключ модели в встроенном интерфейсе управления приложения

Оффлайн-пакет автономный — после установки не требуется подключение к интернету. Если при первом запуске загрузка медленная или ненадежная, можно переключить источник загрузки на зеркало (ghfast / gh-proxy) в настройках.

Способы установки (десктоп: Windows / Linux / macOS)

  1. Скачайте установочный пакет для соответствующей платформы с GitHub Releases (Windows setup.exe или безустановочный zip, Linux tar.gz, macOS zip)
  2. Установите и запустите
  3. На странице приветствия выберите версию ErisPulse SDK для установки (по умолчанию последняя) и установите её
  4. Создайте экземпляр и запустите его

Принцип работы

┌────────────────────────────────────────────────────┐
│  ErisPulse-App (Flutter)                            │
│                                                    │
│  Нативный интерфейс ── REST / WebSocket API панели │
│       │                                            │
│       ├── Android: фоновый сервис + proot + Ubuntu rootfs│
│       │        + Python + экземпляр ErisPulse       │
│       └── Десктоп: встроенный Python + прямое управление процессами │
└────────────────────────────────────────────────────┘
  • Android: экземпляр запускается в фоновом сервисе (background isolate), обёрнутом в proot (chroot в пользовательском режиме) после закрытия интерфейса бот продолжает работать, при падении автоматически перезапускается
  • Десктоп: экземпляр запускается как прямой дочерний процесс приложения; поддержка Windows в минимизированном состоянии в системной панели (закрытие окна не прерывает экземпляр), при перезапуске приложения автоматически восстанавливает управление экземплярами, которые продолжают работать, при выходе из приложения останавливает все экземпляры
  • Нативный интерфейс на всех платформах взаимодействует с экземпляром через REST / WebSocket API по адресу 127.0.0.1:<port>/Dashboard/*, используя тот же API, что и ErisPulse-Dashboard

Отношение к SDK

  • Встроенный в приложение ErisPulse SDK: Android-версия упакована в образ Ubuntu, десктопная версия устанавливается из PyPI
    (при выборе версии на начальном экране, по умолчанию — последняя)
  • Экземпляры в приложении эквивалентны экземплярам, созданным с помощью командной строки epsdk, можно использовать одинаковые модули / адаптеры
  • Разработчики модулей могут зарегистрировать собственные страницы через окно Dashboard:
    Окно автоматически появится в боковой навигации приложения (группировка соответствует Dashboard), при нажатии происходит переход на соответствующую страницу и рендеринг

Связанные ссылки


Далее

  • Управление через браузер на рабочем столе / сервере: ErisPulse-Dashboard (использует тот же API и группы окон, что и приложение)
  • Подключение первой платформы: конфигурация может быть выполнена через встроенный в приложение интерфейс управления, подробности по каждой платформе см. в обзоре возможностей платформ
  • Привыкание к командной строке: экземпляры в приложении и созданные с помощью epsdk полностью эквивалентны, начните с быстрого старта