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ではシステムトレイに最小化、ウィンドウを閉じてもインスタンスを中断しない
  • モジュール動的ウィンドウ:モジュールが登録したページは自動的にサイドナビゲーションに表示(ダッシュボードと同じグループ)、クリックで直ちにアクセス

サポート対象プラットフォーム

すべてのプラットフォームのインストーラーは GitHub Releases からダウンロードできます。必要に応じて選択してください:

プラットフォーム インストールパッケージ 説明
Android online-*.apk / offline-*.apk スマートフォンで直接実行、PCは不要
Windows windows-x64-setup.exe / windows-x64.zip インストール版 / インストール不要版
Linux linux-x64.tar.gz 解凍後すぐに使用可能
macOS macos-arm64.zip Apple Silicon(arm64)

Flutter コードベースで全プラットフォームをカバーしています。

インストール方法(Android / スマートフォンで直接実行)

GitHub Releases から APK をダウンロードしてインストールしてください。2 種類のビルドがあります。

ビルド 実行時イメージ 適用場面
erispulse-app-online-*.apk 初回起動時にダウンロード インストールパッケージが小さく、ネットワーク環境が良い場合に適しています
erispulse-app-offline-*.apk APK に事前にパッケージ化 オフラインで自己完結、インストール後にインターネット接続が不要です

どちらのビルドもインストール手順は同じです。

  1. APK をダウンロードしてインストールし、起動時に通知権限を許可してください(バックグラウンドサービスの維持に使用します)
  2. ホーム画面に初期化の横長バナーが表示されたら、実行をクリックして最初の初期化を実行してください(進行状況とログの表示が可能です)
  3. インスタンスを作成して起動します
  4. App 内の管理画面でアダプタとモデルの 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)                            │
│                                                    │
│  ネイティブ UI ── Dashboard REST / WS API          │
│       │                                            │
│       ├── Android:フォアグラウンドサービス + proot + Ubuntu rootfs│
│       │        + Python + ErisPulse インスタンス     │
│       └── デスクトップ版:内蔵 Python + 直接プロセス管理 │
└────────────────────────────────────────────────────┘
  • Android:インスタンスは、フォアグラウンドサービス(background isolate)によってホストされる proot(ユーザースペース chroot)内で実行されます。UI が閉じても、ロボットは継続的に動作し、クラッシュした場合は自動的に再起動します。
  • デスクトップ版:インスタンスは、App の直接の子プロセスとして実行されます。Windows では、システムトレイに最小化して常駐(ウィンドウを閉じてもインスタンスは中断されません)。App の再起動後は、まだ実行中のインスタンスの管理を自動的に復元し、終了時にはすべてのインスタンスを一括して停止します。
  • すべてのプラットフォームのネイティブ UI は、127.0.0.1:<port>/Dashboard/* の REST / WebSocket API を介してインスタンスと通信し、ErisPulse-Dashboard と同じ API を共有します。

SDKとの関係

  • Appに埋め込まれたErisPulse SDK:Android用はUbuntuイメージにパッケージ化され、デスクトップ用はPyPIからインストールされます (歓迎ページでバージョンを選択可能、デフォルトは最新版)
  • App内のインスタンスとコマンドラインepsdkで作成されたインスタンスは同等であり、同じモジュール/アダプタを使用できます
  • モジュール開発者はDashboardウィンドウ登録APIを使用してカスタムページを登録できます: ウィンドウは自動的にAppのサイドナビゲーションに表示され(Dashboardと同じグループに分類)、クリックすると対応するページがレンダリングされます

関連リンク


次のステップ

  • デスクトップ / サーバー上でブラウザを使って管理:ErisPulse-Dashboard(App と同一の API とウィンドウグループを共有)
  • 最初のプラットフォームに接続:App 内蔵の管理画面で設定が完了でき、各プラットフォームの詳細はプラットフォーム特性一覧を参照
  • コマンドラインに慣れている方へ:App 内のインスタンスは epsdk で作成したものと完全に同等です。クイックスタートから始めてください