Releases: orailnoor/private-agent
Release list
PrivateAgent App v1.0.2
PrivateAgent v1.0.2
This release focuses on Android stability, model-provider support, and safer distribution.
Highlights
- Added NVIDIA NIM provider support.
- Added verified free NVIDIA chat-model discovery.
- Made
z-ai/glm-5.2the default NVIDIA model. - Fixed GLM responses getting stuck on an empty “Thinking…” state.
- Added robust streaming parsing, visible empty-response errors, and a 90-second response timeout.
- Removed the bundled static Kimi API credential and local credential loader.
- Temporarily disabled the floating overlay while its native lifecycle implementation is stabilized.
- Removed overlay permission and special-use overlay service registration from current APKs.
- Added Android “Restricted setting” guidance for enabling accessibility on sideloaded installations.
- Added universal and architecture-specific Android packages.
Downloads
app-universal-release.apk— recommended for most users.app-arm64-v8a-release.apk— modern ARM64 Android phones.app-armeabi-v7a-release.apk— older 32-bit ARM phones.app-x86_64-release.apk— x86_64 Android emulators/devices.SHA256SUMS.txt— file-integrity checksums.
Verification
- Flutter tests passed.
- Universal APK installed and launched as version
1.0.2. - All APK signatures verified.
- All APK checksums verified.
- All APKs pass Android's 16 KB alignment check.
- Universal APK contains ARM64, ARMv7, and x86_64 native libraries.
- APK manifests contain no overlay permission or overlay service.
PrivateAgent App v1.0.1
PrivateAgent v1.0.1
This release adds a redesigned floating assistant experience and improves Android automation reliability.
What's new
- Added a draggable circular assistant bubble that snaps to the nearest screen edge.
- Added a full floating chat panel with synchronized conversation history and live task steps.
- The overlay stays minimized while the agent works and expands only when tapped.
- Added open-app and new-chat controls plus a native drag-to-close target.
- The overlay is automatically hidden while the PrivateAgent app is in the foreground.
- Conversations started in the overlay continue seamlessly inside the main app.
- Added local task-completion notifications with sound and vibration; agent completion no longer uses TTS.
Automation improvements
- Fixed accessibility screen reading so PrivateAgent's own overlay is excluded from AI screen context.
- Fixed foreground detection so the agent can move PrivateAgent aside before reading another app.
- Improved keyboard submission, search-suggestion selection, scrolling, and repeated-action recovery.
- Added clearer live progress steps while keeping final answers concise.
Overlay fixes
- Fixed incorrect bubble size on first launch by consistently converting dp to pixels.
- Fixed left-edge snapping and off-screen bubble positioning.
- Fixed overlay lifecycle races that could produce an empty white square.
- Added reliable background chat/history synchronization.
Downloads
app-arm64-v8a-release.apk— recommended for most modern Android phones.app-armeabi-v7a-release.apk— for older 32-bit ARM devices.app-x86_64-release.apk— for x86_64 Android emulators/devices.SHA256SUMS.txt— release artifact checksums.
Android 8.0 or newer is required. PrivateAgent needs Accessibility and Display over other apps permissions for agent automation and the floating assistant.
PrivateAgent App v1.0.0
PrivateAgent v1.0.0 (Initial Release)
PrivateAgent is an open-source Android automation assistant built with Flutter. It leverages native Android Accessibility Services and large language models (like DeepSeek, GPT-4o, Claude, or Llama) to intelligently interpret screen layouts and execute multi-step automation tasks via natural language commands.
Key Features
Universal AI Support: Uses the standard /chat/completions endpoint, allowing you to plug in almost any AI provider (DeepSeek, OpenAI, Groq, OpenRouter, or even local offline LLMs via LM Studio/Ollama).
Coordinate-Based Interaction: Simulates physical screen taps based on precise coordinate geometry derived from the accessibility tree, mitigating issues with missing text labels or complex UI structures.
Multi-Step Task Execution: Simply type a goal (e.g., "Open Instagram and like the first post"), and the agent will independently read, click, scroll, and type until the goal is achieved.
Dynamic Model Fetching: Easily connect your API key and fetch all available models directly from your chosen provider with a single tap in the settings.
Adjustable Task Limits: Configure the maximum number of automation steps per task (up to 50 steps) to handle complex workflows without getting stuck in endless loops.
Telegram Remote Access (Optional): Control your phone remotely by hooking the agent into a Telegram bot via background polling.
Task Completion Notifications: The app seamlessly integrates with flutter_local_notifications to ping you the moment a long-running automation task finishes.
Shizuku Integration (Optional): Built-in support for Shizuku to allow running elevated ADB commands directly from the device without root access.
Installation
Download the app-arm64-v8a-release.apk from the assets below.
Install the APK on your Android device (API 30+ recommended).
Open the app, navigate to Settings, and input your preferred AI API Base URL and Key.
Enable the "PrivateAgent Screen Control" service in your Android Accessibility Settings.
(Note: Make sure to grant the necessary permissions for Microphone, Notifications, and Contacts for the full suite of automation features).