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 に事前にパッケージ化 | オフラインで自己完結、インストール後にインターネット接続が不要です |
どちらのビルドもインストール手順は同じです。
- 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
次のステップ
- デスクトップ / サーバー上でブラウザを使って管理:ErisPulse-Dashboard(App と同一の API とウィンドウグループを共有)
- 最初のプラットフォームに接続:App 内蔵の管理画面で設定が完了でき、各プラットフォームの詳細はプラットフォーム特性一覧を参照
- コマンドラインに慣れている方へ:App 内のインスタンスは
epsdkで作成したものと完全に同等です。クイックスタートから始めてください