# droidrun/droidrun

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/droidrun-droidrun).**

7,715 stars · 790 forks · Python · mit

## Links

- GitHub: https://github.com/droidrun/droidrun
- Homepage: https://droidrun.ai
- awesome-repositories: https://awesome-repositories.com/repository/droidrun-droidrun.md

## Topics

`ai-agents` `android` `android-automation` `hacktoberfest` `mobile-automation`

## Description

Droidrun is a mobile device automation framework that uses large language models to translate natural language commands into executable actions on mobile operating systems. It functions as an agent orchestrator and UI automation engine, providing a reasoning engine that decomposes complex mobile tasks into smaller, manageable steps.

The system distinguishes itself through a hierarchical action translation process and the ability to analyze accessibility trees and screenshots to determine the visual layout and current status of mobile applications. It supports execution across both physical hardware and managed remote cloud environments, removing the requirement for local hardware setup.

The framework covers several capability areas, including structured data extraction from native mobile applications using natural language queries and telemetry-driven execution tracing to visualize agent decision paths. It also provides a system for extending agent functionality through custom tools and specialized guidance.

## Tags

### Artificial Intelligence & ML

- [Natural Language Command Translation](https://awesome-repositories.com/f/artificial-intelligence-ml/llm-translation-integrations/natural-language-command-translation.md) — Translates natural language commands into executable device-level actions on mobile operating systems using LLMs.
- [Natural Language Device Control](https://awesome-repositories.com/f/artificial-intelligence-ml/natural-language-device-control.md) — Uses large language models to translate natural language commands into direct mobile device actions. ([source](https://docs.droidrun.ai/))
- [AI Agent Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-orchestration.md) — Coordinates specialized agents combining custom instructions and tools for complex mobile workflows.
- [AI Agent Orchestrators](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-agent-orchestrators.md) — Provides a reasoning engine that decomposes complex mobile tasks into traceable and debuggable steps.
- [Multi-step Goal Execution](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-step-goal-execution.md) — Plans and executes sequences of actions by breaking large tasks into smaller, manageable steps. ([source](https://cdn.jsdelivr.net/gh/droidrun/droidrun@main/README.md))
- [Agentic Goal Decomposition](https://awesome-repositories.com/f/artificial-intelligence-ml/task-decompositions/agentic-goal-decomposition.md) — Uses a planning loop to break complex user goals into smaller executable steps via LLMs.
- [Agent Execution Tracing](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-execution-tracing.md) — Logs and visualizes the decision-making path of an agent to debug its operational logic.
- [Agent Capability Extensions](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-capability-extensions.md) — Integrates custom external tools and specialized guidance to expand the functional range of the agent.

### Education & Learning Resources

- [UI State Analysis](https://awesome-repositories.com/f/education-learning-resources/educational-resources/languages-and-programming-concepts/software-engineering-languages/web-programming-and-internet-technologies/mobile-application-development/mobile-inspection-tools/ui-state-analysis.md) — Analyzes accessibility trees and screenshots to determine the current state and visual layout of a mobile app.

### Mobile Development

- [Android Device Controllers](https://awesome-repositories.com/f/mobile-development/android-device-controllers.md) — Provides a controller that executes automation scripts across physical Android hardware and cloud environments.
- [UI State Inspection](https://awesome-repositories.com/f/mobile-development/mobile-infrastructure-security/mobile-synchronization/automation-frameworks/mobile-browser-automation/mobile-ui-automation-frameworks/ui-state-inspection.md) — Analyzes accessibility trees and screenshots to determine the visual layout and current status of a mobile application. ([source](https://cdn.jsdelivr.net/gh/droidrun/droidrun@main/README.md))
- [Native Mobile Automation](https://awesome-repositories.com/f/mobile-development/mobile-infrastructure-security/mobile-synchronization/automation-frameworks/mobile-browser-automation/native-mobile-automation.md) — Inspects accessibility trees and screenshots to retrieve structured data and control native mobile applications.
- [Script Execution Environments](https://awesome-repositories.com/f/mobile-development/mobile-capabilities/script-execution-environments.md) — Provides a managed remote environment for executing mobile app scripts without local hardware. ([source](https://docs.droidrun.ai/))
- [UI Content Extraction](https://awesome-repositories.com/f/mobile-development/mobile-infrastructure-security/mobile-synchronization/automation-frameworks/mobile-browser-automation/mobile-ui-automation-frameworks/ui-content-extraction.md) — Retrieves structured information from native mobile application user interface elements.

### Testing & Quality Assurance

- [Accessibility-Tree Addressing](https://awesome-repositories.com/f/testing-quality-assurance/automation-interaction-tools/element-interaction/accessibility-tree-addressing.md) — Maps application UI hierarchies and screenshots into structured data for agent reasoning and interaction.
- [Native Mobile App Automation](https://awesome-repositories.com/f/testing-quality-assurance/native-mobile-app-automation.md) — Executes sequences of actions on mobile devices by translating natural language instructions into device controls.
- [Mobile Testing Platforms](https://awesome-repositories.com/f/testing-quality-assurance/testing-infrastructure-management/testing-services/mobile-testing-platforms.md) — Provides virtualized mobile devices and cloud environments for running automation scripts.

### Data & Databases

- [Mobile UI Data Extraction](https://awesome-repositories.com/f/data-databases/structured-data-extraction/mobile-ui-data-extraction.md) — Retrieves structured information from native mobile applications using natural language queries. ([source](https://cdn.jsdelivr.net/gh/droidrun/droidrun@main/README.md))

### DevOps & Infrastructure

- [Hardware-Targeted Remote Execution](https://awesome-repositories.com/f/devops-infrastructure/remote-build-orchestration/hardware-targeted-remote-execution.md) — Runs automation scripts in managed cloud environments via a remote connection to mobile hardware.