Mangi-11/Eta

Eta – Android レベルの AI アシスタント

概要

• Eta はスマートフォンをシステム全体にわたる AI エージェントに変える Android アプリです。あなたが設定した大規模言語モデル（OpenAI、Anthropic、Kimi など）が、デバイスとやり取りするツールコールを発行できます。アラーム設定、メディア制御、通知の読み取り、シェルコマンドの実行、ファイルの編集、さらにはアクセシビリティサービスを通じて他のアプリを操作（「GUI エージェント」）することも可能です。
• 中核となるのはエージェントランタイムです。モデルがユーザーのプロンプトを受け取り、呼び出すツールを決定し、アプリがツールを実行して結果をモデルに返し、タスクが完了するまで繰り返すというループで動作します。

主な機能

カテゴリ	Eta でできること
システム API	Android API の直接呼び出し：アラーム、ボリューム、メディア、アプリ情報、権限、ログ（ルートのみ）。
GUI エージェント	アクセシビリティツリーを使用して UI 要素を特定、クリック、スクロール、入力、フル解像度のスクリーンショットを撮影します。
ターミナル	Linux 風シェル（PRoot/chroot による Alpine または Debian）を提供します。モデルは terminal、terminal_job、terminal_daemon コマンドを実行し、出力を確認し、バックグラウンドジョブを保持できます。
ファイルツール	ファイルの読み書き、検索、サイズ制限付き編集、メタデータの表示、Android ディレクトリの /workspace/mounts/ としての公開。
ブラウザ	組み込み WebView でページの読み込み、テキストの読み取り、DOM の操作、スクリーンショットのキャプチャが可能。
パーソナルコンテキスト	最近の通知、アプリ使用状況、連絡先、カレンダー、写真、SMS、健康データ（一部はルートまたは OEM サポートが必要）。
メモリ	ローカルの MEMORY.md ファイルに長期的な会話コンテキストを保存。アプリで編集、クリア、無効化が可能。
スキル & MCP	GitHub や ZIP ファイルから再利用可能な「スキル」パックをインストール。HTTP とベアラートークン（MCP）を使用してリモートツールに接続。
ロール	キャラクターカード（PNG/JSON）を読み込んでアシスタントにペルソナを付与。ロール固有のメモリは通常のチャットとは別に保持。

仕組み

1. モデル選択 – 設定でプロバイダー（OpenAI、Anthropic など）を追加し、API キーを提供します（BYOK）。多くのプロバイダーをサポートし、カスタムの OpenAI 互換エンドポイントを追加できます。
2. ツール呼び出し – LLM は各ツールのスキーマ（例：set_alarm(time)、read_file(path)）を受け取ります。ツールが必要と判断した場合、Eta は対応する Android または Linux 実装を呼び出し、権限を確認し、アクションを実行し、構造化された結果を返します。
3. ランタイムループ – エージェントランタイムは、ストリーミング応答、誘導、キャンセル、増分トランスクリプトを管理します。すべてのアクションはローカルに記録されます。機密性の高いツールパラメータは、会話をエクスポートしない限り永続化されません。
4. エントリポイント – 電源ボタンの長押しから起動するか、OEM アシスタントをハイジャックして起動できます（「小布」/「超级小爱」用 Xposed モジュール）。深いシステム統合には LSPosed が必要です。

インストールと使用方法

• Releases ページから APK をダウンロードし、Android 13+ にインストールします。
• モデルプロバイダーを設定し、必要なツールを有効にします（GUI 用アクセシビリティサービス、通知権限、位置情報など）。
• チャットを開始し、リクエストを入力または音声で送信します（例：「明日の会議を予定して、議題を連絡先に送って」）。Eta は適切なツールを呼び出し、ステータスカプセルに進行状況を表示し、最終回答を返します。

対象ユーザー

• スマートフォンでプログラム可能なクロスアプリアシスタントを求めるパワーユーザー。
• ルートなしで Android での LLM 駆動自動化を試したい開発者（ルートで追加機能が利用可能）。
• 言語モデル用に独自の API キーを提供できる人。

制限事項

• AI 部分は外部サービス上で動作します。Eta にはローカルモデルは含まれません。
• 一部の個人データ（SMS、カレンダー、健康）はルートまたは OEM 固有のフックが必要です。
• Xposed/LSPosed 統合はオプションです。これがないとシステムアシスタントのエントリポイントが失われます。
• ライセンスは非商用で、作者の許可なくアプリを販売または再配布することはできません。

重要性 Eta は、デスクトップクラスのコーディングエージェント（完全なファイルシステムとシェルアクセスを持つ）と、通常は単純な Q&A に制限されるモバイルアシスタントとの間のギャップを埋めます。Android API と Linux ターミナルを LLM に公開することで、スマートフォンで真にエージェント的なワークフローを可能にします。例えば、複数のアプリからデータを自動的に収集し、スクリプトで処理し、結果に基づいて行動するといったことを、すべて自然言語のプロンプトで実現できます。

---

上記の情報はすべてリポジトリの README から直接取得しています。