Eta  by Mangi-11

AI Agent for Android enabling system-wide GUI and shell command execution

Created 5 months ago
364 stars

Top 77.1% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Eta AI Agent for Android provides a system-level AI agent for ColorOS 16, merging GUI manipulation and terminal command execution for advanced automation. It targets power users and developers seeking to extend Android's AI capabilities beyond vendor limitations, enabling cross-app task execution and custom model integration.

How It Works

Eta is an Xposed module (API 102) hooking core Android processes. Its Agent Runtime executes tasks in a loop: model instructions are processed via GUI actions or shell commands, results feed back, and the model decides the next step. This dual capability controls the screen, interacts with apps, and inputs text, while also running shell commands, managing files, and executing scripts, treating the shell as a complete computational environment. A specialized, secure in-app browser handles web content.

Quick Start & Requirements

Install APK in LSPosed (API 102), scope system, SystemUI, Google App, "小布" assistant. Reboot, configure model providers/API keys in-app. Permissions: floating window, accessibility, background; root mandatory for terminal/file ops and system config recovery. Targets ColorOS 16.

Highlighted Details

  • System-Level Integration: Xposed hooks enable deep system access beyond app sandboxes.
  • Dual-Mode Operation: Combines GUI control (screenshots, clicks, scrolls, input) with terminal access (shell, file I/O, scripting).
  • BYOK Model Support: Integrates user-defined AI models (OpenAI-compatible, Anthropic, etc.) via API keys.
  • Secure In-App Browser: Dedicated agent loads JavaScript, extracts structured content, and interacts with web elements securely.
  • System Entry Point Hooks: Triggerable via "小布" assistant or power button gestures for complex tasks.

Maintenance & Community

Functionality depends on specific ColorOS/Google App versions; updates may require re-adaptation. Early hook features are maintained. Community links sparse ("LINUX DO"). No contributor/sponsorship details.

Licensing & Compatibility

The README omits a software license, making commercial use unclear. Compatibility targets ColorOS 16; hooks sensitive to system app updates.

Limitations & Caveats

As a third-party Xposed module, Eta lacks vendor-assistant UI fluidity/consistency. OS/app updates can break functionality. Full capabilities require root/LSPosed, carrying security/warranty implications.

Health Check
Last Commit

5 days ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
2
Star History
8 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.