搜索插件、代码仓与 APP 分类

GitHub 代码仓orailnoor/private-agent

私人代理

PrivateAgent 是一个使用 Flutter 构建的开源 Android 自动化代理。它利用 DeepSeek API 和原生 Android 可访问性服务来解析屏幕布局,并通过自然语言命令在任何已安装的应用程序中执行多步骤任务。

私人代理 项目封面
星标
329
复刻
141
最近推送(UTC)
2026年7月17日
项目状态
未归档

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

PrivateAgent

PrivateAgent is an open-source Android automation agent built with Flutter. It utilizes the DeepSeek API and native Android Accessibility Services to interpret screen layouts and execute multi-step tasks across any installed application via natural language commands.

Architecture

The system operates on a continuous feedback loop:

  1. The user issues a command (via voice, text, or Telegram remote access).
  2. The agent captures the current screen hierarchy, calculating the exact spatial coordinates of all interactive elements.
  3. The layout data is transmitted to the AI provider alongside the current task context and the result of the previous action.
  4. The AI determines the next optimal action (e.g., clicking specific coordinates, inputting text, scrolling).
  5. The native Android layer executes the action.
  6. The loop repeats until the task is marked as complete.

Capabilities

  • Screen Reading: Parses the Android UI tree to map clickable, scrollable, and editable elements.
  • Coordinate-Based Interaction: Simulates physical screen taps based on coordinate geometry, mitigating issues with missing text labels or inaccessible icons.
  • Remote Access: Integrates with the Telegram Bot API via background polling, allowing users to issue commands and monitor task execution progress remotely.
  • Voice Control: Native speech-to-text integration for hands-free operation.

Installation

Download the latest APK directly from the Releases Page.

Choose app-universal-release.apk when it is available. It supports ARM64, 32-bit ARM, and x86_64 devices in one package. If a release only provides split APKs, most modern Android phones—including Snapdragon devices—must use app-arm64-v8a-release.apk.

PrivateAgent supports Android 8.0 (API 26) and newer. Current release builds are also checked for Android 15/16's 16 KB native-library alignment requirement.

Setup Instructions (How to use for FREE)

This app requires an AI brain to operate. You can use it 100% for free by using OpenRouter's free models.

  1. Install the APK on your Android device (API 30+ recommended).
  2. Go to OpenRouter.ai and create a free account.
  3. Generate a free API Key.
  4. Launch PrivateAgent and go to the Settings screen.
  5. Tap the "OpenRouter" quick-select chip under Base URL.
  6. Paste your API Key.
  7. Type openai/gpt-oss-120b:free (or any other free model) into the Model field.
  8. Enable the "PrivateAgent Screen Control" service in your Android Accessibility Settings.
“Restricted setting” when enabling Screen Control

Android may block accessibility access for apps installed from an APK. This is an operating-system safety restriction:

  1. Open Settings → Apps → PrivateAgent.
  2. Open the three-dot menu in the top-right corner.
  3. Tap Allow restricted settings and confirm.
  4. Return to PrivateAgent and open Accessibility Settings again.
  5. Enable PrivateAgent Screen Control.

PrivateAgent now shows these instructions and provides shortcuts to both App Info and Accessibility Settings during onboarding.

Telegram Integration

To enable remote access:

  1. Acquire a bot token from BotFather on Telegram.
  2. Input the token in the PrivateAgent Settings screen and enable the integration toggle.
  3. The application will maintain a background polling connection to the Telegram API to receive commands.

License

This project is open-source and available for modification.

Noor GitHub avatar
GitHub 作者

Noor ↗

Learning, tinkering, and making things that probably shouldn't work.

语言DartHTMLJavaKotlin

使用的依赖

依赖清单 22 项

所在榜单

如何选择适合项目的代码仓?

先按使用场景筛选,再比较项目活跃情况,最后到原始仓库核对使用要求。

  1. 通过仓库名、作者或描述搜索,再按技术分类缩小范围。
  2. 结合星标、复刻与最近推送比较项目;星标反映社区关注,不代表质量保证。
  3. 使用前在 GitHub 核对 README、许可证与 Issues。

来源与维护

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗