Repolode
droidrun

droidrun/mobilerun

Framework open source de Python para que agentes LLM controlen teléfonos Android e iOS mediante lenguaje natural, CLI o API de Python.

Estrellas
9,708
Forks
1,034
Issues abiertos
28
Último commit
hace 4 días

¿Qué es?

Mobilerun es un framework que permite a agentes basados en modelos de lenguaje operar dispositivos móviles. A partir de una instrucción en lenguaje natural, como abrir los ajustes y activar el modo oscuro, el agente lee el estado de la interfaz del dispositivo, consulta capturas de pantalla cuando lo necesita y realiza toques, deslizamientos e ingreso de texto paso a paso hasta completar la tarea.

El framework funciona con diversos proveedores de LLM, como OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek y OpenRouter, además de endpoints compatibles con OpenAI. Ofrece una CLI para tareas puntuales y comprobaciones de dispositivos, Docker para crear entornos reproducibles y una API de Python para flujos de trabajo personalizados con herramientas propias y salida estructurada. Android se controla mediante una aplicación complementaria llamada Portal a través de ADB, e iOS se admite mediante un proceso de configuración independiente.

Los modos opcionales permiten controlar solo mediante capturas de pantalla las apps que no ofrecen datos de accesibilidad, usar un modo de razonamiento que separa la planificación de la ejecución para tareas más largas y hacer trazas con Arize Phoenix o Langfuse.

Funciones clave

  • 01Controla dispositivos Android e iOS mediante instrucciones en lenguaje natural
  • 02Funciona con OpenAI, Anthropic, Gemini, Ollama, DeepSeek y otros modelos compatibles con OpenAI
  • 03Combina árboles de accesibilidad con capturas de pantalla, o funciona solo con capturas de pantalla
  • 04Ofrece una CLI, una imagen de Docker y una API de Python con herramientas personalizadas
  • 05Admite un modo de razonamiento para planificar tareas de varios pasos y hacer trazas de ejecución con Phoenix o Langfuse

Casos de uso

  • Control de calidad y pruebas de regresión de apps móviles a partir de pasos de prueba en lenguaje natural
  • Automatización de tareas repetitivas en uno o varios teléfonos
  • Extracción de datos de apps móviles nativas que no tienen una API
  • Ejecución de flujos de trabajo móviles desde scripts o tareas programadas mediante la API de Python

Inicio rápido

  1. 1

    Instala la CLI con uv

    uv tool install mobilerun
  2. 2

    Instala la aplicación Portal y activa su servicio de accesibilidad en tu dispositivo Android (se requieren ADB y la depuración USB)

    mobilerun setup
  3. 3

    Configura tu proveedor de LLM

    mobilerun configure
  4. 4

    Ejecuta tu primera tarea en lenguaje natural

    mobilerun run "Open settings and turn on dark mode"

Antes de usarlo

  • Se necesita una clave API de pago de un proveedor de LLM o una configuración de modelo local.
  • Python 3.14 no es compatible; usa Python 3.11 a 3.13.
  • Para controlar Android se necesita ADB y un dispositivo con la depuración USB activada.

Temas

Preguntas frecuentes

¿Qué es mobilerun?
Framework open source de Python para que agentes LLM controlen teléfonos Android e iOS mediante lenguaje natural, CLI o API de Python. Mobilerun es un framework que permite a agentes basados en modelos de lenguaje operar dispositivos móviles. A partir de una instrucción en lenguaje natural, como abrir los ajustes y activar el modo oscuro, el agente lee el estado de la interfaz del dispositivo, consulta capturas de pantalla cuando lo necesita y realiza toques, deslizamientos e ingreso de texto paso a paso hasta completar la tarea.
¿mobilerun es gratuito? ¿Qué licencia tiene?
mobilerun es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿mobilerun sigue mantenido?
Mantenimiento activo. El último commit de mobilerun fue el 16 oct 2026.
¿Para qué puedo usar mobilerun?
Control de calidad y pruebas de regresión de apps móviles a partir de pasos de prueba en lenguaje natural Automatización de tareas repetitivas en uno o varios teléfonos Extracción de datos de apps móviles nativas que no tienen una API Ejecución de flujos de trabajo móviles desde scripts o tareas programadas mediante la API de Python
¿Cómo se instala mobilerun?
Instala la CLI con uv: uv tool install mobilerun Instala la aplicación Portal y activa su servicio de accesibilidad en tu dispositivo Android (se requieren ADB y la depuración USB): mobilerun setup Configura tu proveedor de LLM: mobilerun configure Ejecuta tu primera tarea en lenguaje natural: mobilerun run "Open settings and turn on dark mode"
¿Dónde consigo mobilerun?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/droidrun/mobilerun

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados