ErisPulse-App
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 に事前にパッケージ化 | オフラインで自己完結、インストール後にインターネット接続が不要です |
どちらのビルドもインストール手順は同じです。
- APK をダウンロードしてインストールし、起動時に通知権限を許可してください（バックグラウンドサービスの維持に使用します）
- ホーム画面に初期化の横長バナーが表示されたら、実行をクリックして最初の初期化を実行してください（進行状況とログの表示が可能です）
- インスタンスを作成して起動します
- App 内の管理画面でアダプタとモデルの API キーを設定します
オフラインパッケージは自己完結型です。インストール後はネットワーク接続が不要です。初回起動時のダウンロードが遅いまたは不安定な場合は、設定ページでダウンロードソースをミラー（ghfast / gh-proxy）に切り替えてください。
インストール方法（デスクトップ版：Windows / Linux / macOS）
- GitHub Releases から対応するプラットフォーム用のインストールパッケージをダウンロードしてください。
（Windows は
setup.exeまたは無印のzip、Linux はtar.gz、macOS はzip） - インストールして起動します
- ウェルカムページでインストールする ErisPulse SDK のバージョンを選択してください（デフォルトは最新版です）
- インスタンスを作成して起動します
動作原理
┌────────────────────────────────────────────────────┐
│ 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と同じグループに分類）、クリックすると対応するページがレンダリングされます
関連リンク
- GitHub リポジトリ: https://github.com/ErisPulse/ErisPulse-App
- ダウンロード: GitHub Releases
- 議論: Discussions