PrivateAgent v1.0.0 — Autonomous On-Device Android AI Agent

🧞 PrivateAgent v1.0.0 — Autonomous On-Device AI Agent

**PrivateAgent** turns any OpenAI-compatible LLM into an autonomous Android UI automation agent. Using Android's Accessibility Service, it observes your screen, reasons about what it sees, and takes actions

(tapping, typing, swiping) until your goal is reached.

> 🔒 **100% On-Device Privacy:** Your keys, your data, your device. No telemetry, no third-party analytics, and all states/macros are stored locally via `SharedPreferences`.

---

### ✨ Key Features

- 🤖 **Autonomous Feedback Loop (Observe → Think → Act):**
  - Reads active screen hierarchies into compact, token-friendly representations.
  - LLM plans actions and executes them natively on the phone.
- 🧠 **Skill Memory (Macro Replay):**
  - Automatically records successful execution sequences.
  - Replays repeated tasks locally as macros with **0 LLM token cost** and near-instant speed.
- 🔌 **Universal LLM Compatibility:**
  - Works with **Ollama** (100% offline & local), **DeepSeek**, **OpenRouter**, **NVIDIA NIM**, or any OpenAI-compatible custom endpoint.
- 📱 **Telegram Remote Control:**
  - Control your phone remotely via a Telegram bot.
  - Send natural language commands, query `/status`, capture live `/screenshot`, or cancel tasks on the fly.
- 🪟 **Floating Overlay Assistant:**
  - Launch and monitor tasks from any app with a floating overlay bubble and transcript panel.
- 🔁 **Built-in Recovery Engine:**
  - Detects loops and stuck screens, automatically attempting recovery (scrolling, backing out, or retrying).
- 🎙️ **Voice & System Controls:**
  - Speech-to-text input & text-to-speech output.
  - Native volume, screen brightness control, and optional Shizuku privileged shell integration.

---

### 📦 Asset Details

| File | Type | Target Architecture | Min Android Version |
|---|---|---|---|
| `PrivateAgent-debug.apk` | Android APK | `arm64-v8a`, `armeabi-v7a`, `x86_64` | Android 8.0+ (API 26) |

---

### 🚀 Getting Started & Installation

1. **Download & Install:**
   - Download `PrivateAgent-debug.apk` from the Assets below and install it on your Android device (allow *Install Unknown Apps* if prompted).
2. **Complete Onboarding:**
   - Open PrivateAgent and complete the initial setup walkthrough.
3. **Enable Accessibility Service (Crucial):**
   - Go to **Android Settings → Accessibility → Downloaded Apps / Installed Services**.
   - Enable **PrivateAgent Accessibility Service** (grant requested permissions so the agent can read screens and perform gestures).
4. **Configure your LLM Provider:**
   - Navigate to **Settings** in the app.
   - Choose your provider (**OpenRouter**, **DeepSeek**, **Ollama**, etc.) and input your API key and model name (e.g., `deepseek-chat` or `gpt-4o-mini`).
5. **Start Automating:**
   - Enter a goal in chat or speak via microphone (e.g., *"Open Settings and turn on Dark Mode"* or *"Open WhatsApp and send 'Hello' to Mom"*).

---

### ⚠️ Notes & Precautions

- **Permissions:** Automation requires the Android Accessibility Service and Overlay permission.
- **Safety First:** PrivateAgent interacts directly with your device's UI. Start with simple goals and supervise actions before running sensitive workflows.