Skip to content
Back to search

aohp

An OS-level agent harness for personalized, efficient and secure interaction

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aohp-os--aohp/badge.svg)](/listings/aohp-os--aohp)

HTML

<a href="/listings/aohp-os--aohp"><img src="/api/listings/aohp-os--aohp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

AOHP is built on AOSP. This repository hosts project documentation and the unified development framework. Source trees live in the `aohp-os` GitHub organization and are pulled in via [local_manifests](https://github.com/aohp-os/local_manifests).

Quick start

# 1. Clone the dev framework
git clone git@github.com:aohp-os/aohp.git
cd aohp

# 2. Initialize AOSP + AOHP manifests (Android 16 QPR2; see guide for mirror/proxy options)
cd AOSP && repo init -b android16-qpr2-release
cd .repo && git clone git@github.com:aohp-os/local_manifests.git && cd ..
repo sync -j4

# 3. Build
bash scripts/build.sh

# 4. Launch Cuttlefish (after envsetup + lunch)
source AOSP/build/envsetup.sh
lunch aosp_cf_x86_64_phone_aohp-trunk_staging-userdebug
sudo -E bash -c 'ulimit -n 65536; '"$ANDROID_HOST_OUT"'/bin/launch_cvd --report_anonymous_usage_stats=n' &

Open the emulator at **https://localhost:8443/**.

Full development guide

Setup, networking, multi-instance Cuttlefish, sandbox options, and contribution workflow are documented in **[Development Guide](docs/DEVELOPMENT.md)**.

You can also clone this repo for project overview and updates:

git clone https://github.com/aohp-os/aohp.git

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 227 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <h1 align="center">AOHP: Android Open Harness Project</h1>
  2. <p align="center">
  3. <strong>Let the OS proactively adapt to its user via agentic AI.</strong>
  4. </p>
  5. <p align="center">
  6. <a href="#real-world-demos"><img src="https://img.shields.io/badge/Demo-Recordings-green?style=for-the-badge" alt="Demos"></a>
  7. <a href="https://arxiv.org/abs/2606.23449"><img src="https://img.shields.io/badge/Paper-ARXIV%3A2606.23449-C00000?labelColor=4D4D4D&amp;style=for-the-badge" alt="Paper"></a>
  8. <a href="LICENSE"><img src="https://img.shields.io/badge/License-Apache_2.0-yellow?style=for-the-badge" alt="License"></a>
  9. </p>
  10. <p align="center">
  11. <a href="https://github.com/MobileLLM/lab-contact"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a>
  12. <a href="https://discord.gg/3bhPrAarW"><img src="https://img.shields.io/badge/Discord-Group-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a>
  13. <a href="https://x.com/yuanchun_li/status/2069293026577629298"><img src="https://img.shields.io/badge/X-Posts-555555?style=flat&logo=x&logoColor=white&labelColor=000000" alt="X"></a>
  14. </p>
  15. <p align="center">
  16. <a href="docs/README.zh-CN.md">中文文档</a> ·
  17. <a href="docs/DEVELOPMENT.md">Development Guide</a> ·
  18. <a href="docs/DEVELOPMENT.zh-CN.md">开发指南</a>
  19. </p>
  20. <strong>🎬 <a href="#real-world-demos">See Demos</a></strong>: Watch AOHP generate personalized user-defined apps and complete cross-app tasks.
  21. ---
  22. ## Why AOHP?
  23. Traditional OS puts apps at the center. Users navigate **developer-defined app interfaces** to do everything, which may be tedious and distracting.
  24. AOHP shifts the OS toward deeper personalization.
  25. It introduces **user-defined apps**, which are generated based on the user's actual needs and are backed by AI agents under the hood.
  26. The agents use system APIs, CLIs and GUI-based apps in the background to compose actual services.
  27. To make such experience **feasible, efficient and secure**. Many components in the system and framework layers have to be redesigned, but not all. That's why we introduce AOHP, an OS-level agent harness to enable personalized, efficient and secure interaction.
  28. <p align="center">
  29. <img src="./images/comparison.png" alt="Traditional Android vs AOHP architecture" width="95%"/>
  30. </p>
  31. > [!IMPORTANT]
  32. > **AOHP is an early-stage research prototype**.
  33. > It is not ready for production deployments or security-critical workloads.
  34. >
  35. > We will keep improving the reliability, compatibility, and security coverage.
  36. > Feedback and contributions are welcome.
  37. ---
  38. ## Design
  39. AOHP features a set of efficient agent interfaces and a secure information flow tracking mechanism, which together foster the core capabilities to enable personalized service composition. The system architecture:
  40. <p align="center">
  41. <img src="./images/overview.png" alt="AOHP System Architecture" width="95%"/>
  42. </p>
  43. A comparison between AOHP and stock Android:
  44. | Dimension | Stock Android | AOHP |
  45. | ----------------------- | ------------------------------------------------------------- | ------------------------------------------------------------- |
  46. | **Interaction Model** | Users operate app-defined workflows directly | Agents act as first-class OS actors under user intent |
  47. | **Interaction Surface** | Fixed app GUIs defined by developers | Personalized service entrances mediated by agents |
  48. | **Process Execution** | Single-tenant foreground execution bound to physical displays | Parallel background interaction decoupled from the screen |
  49. | **System Memory** | Fragmented and locked inside individual applications | OS-managed cross-app memory for task personalization |
  50. | **Security & Privacy** | Coarse-grained app permissions and opaque data flows | Fine-grained data-flow tracking and sandboxed sensitive values|
  51. ---
  52. <a id="real-world-demos"></a>
  53. ## 🎬 Demos
  54. AOHP ships as a runnable AOSP fork.
  55. The recordings below come from the compiled system image.
  56. ### User-Defined Apps
  57. Given a natural-language prompt, AOHP produces a fully-functional app, including the frontend UI and background logic supported by agents.
  58. <table align="center">
  59. <tr>
  60. <td align="center" width="33%"><strong>Health Hub</strong><br><sub>Unified Fitness & Sleep Dashboard</sub></td>
  61. <td align="center" width="33%"><strong>Gift Picker</strong><br><sub>Luxury Gift Recommendation for 520</sub></td>
  62. <td align="center" width="33%"><strong>Python Learning Assistant</strong><br><sub>Kid-Friendly Programming Tutor</sub></td>
  63. </tr>
  64. <tr>
  65. <td align="center"><a href="./demos/uda/health_hub_demo.mp4"><img src="./demos/uda/health_hub_demo.gif" alt="Health Hub demo" width="250"/></a></td>
  66. <td align="center"><a href="./demos/uda/gift_picker_demo.mp4"><img src="./demos/uda/gift_picker_demo.gif" alt="Gift Picker demo" width="250"/></a></td>
  67. <td align="center"><a href="./demos/uda/python_learning_assistant_demo.mp4"><img src="./demos/uda/python_learning_assistant_demo.gif" alt="Python Learning Assistant demo" width="250"/></a></td>
  68. </tr>
  69. <tr>
  70. <td align="center"><sub>Aggregate fitness, sleep, and weight records from different apps into a unified health management app.</sub></td>
  71. <td align="center"><sub>Generate a luxury gift selection app for my anniversity. Find gift information from all shopping apps.</sub></td>
  72. <td align="center"><sub>Generate a Python learning app for my child. Include courses and exercises. Track progress and report to me via messages every day.</sub></td>
  73. </tr>
  74. </table>
  75. ### Agent Execution
  76. AOHP provides personalized services by orchestrating APIs, CLIs, GUIs, memory, skills, etc. with AI agents.
  77. <table align="center">
  78. <tr>
  79. <td align="center" width="33%"><strong>UI Micro-operations</strong></td>
  80. <td align="center" width="33%"><strong>File Handling</strong></td>
  81. <td align="center" width="33%"><strong>Event Capture</strong></td>
  82. </tr>
  83. <tr>
  84. <td align="center"><a href="./demos/agent/gallery_brightness.mp4"><img src="./demos/agent/gallery_brightness.gif" alt="Gallery brightness demo" width="250"/></a></td>
  85. <td align="center"><a href="./demos/agent/cloud_file_markor.mp4"><img src="./demos/agent/cloud_file_markor.gif" alt="Cloud file Markor demo" width="250"/></a></td>
  86. <td align="center"><a href="./demos/agent/event_capture.mp4"><img src="./demos/agent/event_capture.gif" alt="Event Capture demo" width="250"/></a></td>
  87. </tr>
  88. </table>
  89. ---
  90. ## Evaluation Highlights
  91. We evaluate AOHP with [OpenClaw](https://github.com/openclaw/openclaw) against stock Android.
  92. The benchmark has 30 real-world mobile tasks.
  93. They cover GUI operation, non-GUI operation, event capture, multi-source retrieval, memory management, and hybrid workflows.
  94. ### Task Completion
  95. Each task is scored by objective checkpoints, so partially completed tasks still receive partial credit.
  96. | Setting | Completion Rate | Fully Solved | Partially Completed |
  97. | ------- | --------------- | ------------ | ------------------- |
  98. | OpenClaw on stock Android | 54.44% | 13 / 30 | 7 / 30 |
  99. | OpenClaw on AOHP | **75.56%** | **20 / 30** | 5 / 30 |
  100. | Gain | **+21.12%** | **+7 tasks** | - |
  101. ### Execution Cost
  102. To compare cost fairly, we report the 11 tasks that both systems solve completely.
  103. | Setting | Tool Calls | Duration | Tokens | LLM Requests |
  104. | ------- | ---------- | -------- | ------ | ------------ |
  105. | OpenClaw on stock Android | 233 | 33.94 min | 7.10M | 273 |
  106. | OpenClaw on AOHP | **129** | **18.93 min** | **3.44M** | **143** |
  107. | Reduction | **44.64%** | **44.21%** | **51.55%** | **47.62%** |
  108. ### Information-Flow Security
  109. AOHP is also evaluated with security-oriented test cases.
  110. The system enforces all five policy cases:
  111. | Security Check | Result |
  112. | -------------- | ------ |
  113. | Sensitive display uses vault references, not plaintext | Pass |
  114. | Ordinary non-sensitive actions proceed without extra approval | Pass |
  115. | Sensitive transfers and payment confirmation require user consent | Pass |
  116. | Unsupported access fails closed | Pass |
  117. | Sensitive events are redacted and preserve taint metadata | Pass |
  118. ---
  119. ## Getting Started
  120. AOHP is built on AOSP. This repository hosts project documentation and the unified development framework.
  121. Source trees live in the `aohp-os` GitHub organization and are pulled in via [local_manifests](https://github.com/aohp-os/local_manifests).
  122. ### Quick start
  123. ```bash
  124. # 1. Clone the dev framework
  125. git clone git@github.com:aohp-os/aohp.git
  126. cd aohp
  127. # 2. Initialize AOSP + AOHP manifests (Android 16 QPR2; see guide for mirror/proxy options)
  128. cd AOSP && repo init -b android16-qpr2-release
  129. cd .repo && git clone git@github.com:aohp-os/local_manifests.git && cd ..
  130. repo sync -j4
  131. # 3. Build
  132. bash scripts/build.sh
  133. # 4. Launch Cuttlefish (after envsetup + lunch)
  134. source AOSP/build/envsetup.sh
  135. lunch aosp_cf_x86_64_phone_aohp-trunk_staging-userdebug
  136. sudo -E bash -c 'ulimit -n 65536; '"$ANDROID_HOST_OUT"'/bin/launch_cvd --report_anonymous_usage_stats=n' &
  137. ```
  138. Open the emulator at **https://localhost:8443/**.
  139. ### Full development guide
  140. Setup, networking, multi-instance Cuttlefish, sandbox options, and contribution workflow are documented in **[Development Guide](docs/DEVELOPMENT.md)**.
  141. You can also clone this repo for project overview and updates:
  142. ```bash
  143. git clone https://github.com/aohp-os/aohp.git
  144. ```
  145. ---
  146. ## License
  147. AOHP is licensed under the [Apache License, Version 2.0](LICENSE).
  148. ---
  149. ## Citation
  150. ```bibtex
  151. @misc{zhao2026aohp,
  152. title={AOHP: An Open-Source OS-Level Agent Harness for Personalized, Efficient and Secure Interaction},
  153. author={Shanhui Zhao and Jiacheng Liu and Guohong Liu and Jichao Yan and Jialei Ye and Yuhao Yang and Hao Wen and Shizuo Tian and Yizhen Yuan and Yuxuan Chen and Yunxin Liu and Ju Ren and Ya-Qin Zhang and Chao Huang and Yao Guo and Yuanchun Li},
  154. year={2026},
  155. eprint={2606.23449},
  156. archivePrefix={arXiv},
  157. primaryClass={cs.AI},
  158. url={https://arxiv.org/abs/2606.23449},
  159. }
  160. ```
  161. ---
  162. <p align="center">
  163. <i>The OS is no longer only a substrate for human-operated applications — it becomes the environment in which agents perceive, plan, act, and enforce user intent.</i>
  164. </p>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.