Skip to main content
Welcome to the Droidrun Guides! This section provides step-by-step instructions and best practices for using Droidrun. Each guide focuses on a specific aspect of the framework, from device setup to advanced automation patterns.

​
Available Guides

​
Getting Started

CLI Reference - Complete command-line interface guide
  • All CLI commands (run, setup, devices, connect, ping, macro)
  • Configuration overrides and flags
  • Environment variables and API keys
  • Common workflows and troubleshooting
Device Setup - Set up Android and iOS devices
  • Portal app installation and configuration
  • Accessibility service enablement
  • TCP vs Content Provider communication
  • Wireless debugging and multi-device management
Configuration System - Master the config-driven architecture
  • YAML configuration structure
  • LLM profiles per agent (Manager, Executor, CodeAct, Scripter)
  • Mixing LLM providers (OpenAI, Anthropic, Google, Ollama, DeepSeek)
  • Safe execution, prompts, and app cards

​
Templates

Explore real-world examples and starter projects in the droidrun-examples repository:
  • LinkedInJobsScraper - Agentic workflow that searches LinkedIn for roles, evaluates matches, and prepares tailored applications
  • LinkedInLeads - End-to-end lead discovery and enrichment for LinkedIn companies and roles
  • TwitterPost - Finds trending topics, drafts posts, and generates images to publish on X/Twitter
  • play2048 - DroidAgent that plays the 2048 game on play2048.co
Each example includes a self-contained workflow with entrypoint, configuration, and sample data. See the README for setup instructions and contribution guidelines. https://github.com/droidrun/droidrun-examples
Need help? Join our Discord community for support and discussions.
⌘I