Kit de herramientas que genera interfaces de línea de comandos nativas para agentes a partir de software existente e incluye CLI-Hub, un registro para instalar CLIs listas para usar.
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
Instala la CLI con uv
uv tool install mobilerun - 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
Configura tu proveedor de LLM
mobilerun configure - 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
Automatización de Android mediante lenguaje natural para asistentes de programación con IA y suites de pruebas, en teléfonos reales o emuladores.
SDK oficial de Python para crear servidores y clientes de Model Context Protocol que conectan aplicaciones con LLM con herramientas, datos y prompts.
Un framework de agentes que conecta humanos digitales (2.5D, 3D, móvil, PC y web) y LLM con sistemas empresariales.
Framework agéntico de generación de video que convierte una idea, un guion o una novela en un video con varios planos mediante agentes coordinados.
Herramienta de línea de comandos y biblioteca de Python para ejecutar prompts y chats con modelos de lenguaje grandes, remotos o instalados localmente.