Toolkit que gera interfaces de linha de comando nativas para agentes a partir de softwares existentes e oferece o registro CLI-Hub para instalar CLIs prontas.
54,9 mil5 milPythonApache-2.0Atualizado há 29 dias
droidrun/mobilerun
Framework Python de código aberto que permite a agentes LLM controlar celulares Android e iOS por linguagem natural, CLI ou API Python.
- Estrelas
- 9,708
- Forks
- 1,034
- Issues abertas
- 28
- Último commit
- há 4 dias
O que é?
Mobilerun é um framework que permite a agentes de modelos de linguagem de grande porte operar dispositivos móveis. Com uma instrução em linguagem natural, como abrir as configurações e ativar o modo escuro, o agente lê o estado da interface do dispositivo, consulta capturas de tela quando necessário e executa toques, gestos de deslizar e inserções de texto, passo a passo, até concluir a tarefa.
O framework funciona com vários provedores de LLM, incluindo OpenAI, Anthropic, Gemini, xAI, Ollama, DeepSeek e OpenRouter, além de endpoints compatíveis com OpenAI. Ele oferece uma CLI para tarefas pontuais e verificações de dispositivos, Docker para ambientes reproduzíveis e uma API Python para fluxos de trabalho personalizados com ferramentas próprias e saída estruturada. O controle do Android é feito por meio de um app complementar, Portal, via ADB; o iOS é compatível por meio de um processo de configuração separado.
Os modos opcionais incluem controle apenas por capturas de tela para apps sem dados de acessibilidade, um modo de raciocínio que separa o planejamento da execução em tarefas mais longas e rastreamento por meio do Arize Phoenix ou do Langfuse.
Recursos principais
- 01Controla dispositivos Android e iOS com comandos em linguagem natural
- 02Funciona com OpenAI, Anthropic, Gemini, Ollama, DeepSeek e outros modelos compatíveis com OpenAI
- 03Combina árvores de acessibilidade com capturas de tela ou usa o modo apenas por capturas de tela
- 04Oferece uma CLI, uma imagem Docker e uma API Python com ferramentas personalizadas
- 05Oferece um modo de raciocínio para planejamento em várias etapas e rastreamento da execução via Phoenix ou Langfuse
Casos de uso
- QA de apps móveis e testes de regressão com etapas de teste em linguagem simples
- Automatizar tarefas repetitivas em um ou vários celulares
- Extrair dados de apps móveis nativos que não têm API
- Executar fluxos de trabalho móveis por scripts ou agendamentos via API Python
Início rápido
- 1
Instale a CLI com uv
uv tool install mobilerun - 2
Instale o app Portal e ative o serviço de acessibilidade no seu dispositivo Android (é necessário ter ADB e a depuração USB ativados)
mobilerun setup - 3
Configure seu provedor de LLM
mobilerun configure - 4
Execute sua primeira tarefa em linguagem natural
mobilerun run "Open settings and turn on dark mode"
Antes de usar
- É necessária uma chave de API paga de um provedor de LLM ou uma configuração de modelo local.
- Python 3.14 não é compatível; use Python 3.11 a 3.13.
- Para controlar o Android, é necessário ter ADB e um dispositivo com a depuração USB ativada.
Tópicos
Perguntas frequentes
- O que é mobilerun?
- Framework Python de código aberto que permite a agentes LLM controlar celulares Android e iOS por linguagem natural, CLI ou API Python. Mobilerun é um framework que permite a agentes de modelos de linguagem de grande porte operar dispositivos móveis. Com uma instrução em linguagem natural, como abrir as configurações e ativar o modo escuro, o agente lê o estado da interface do dispositivo, consulta capturas de tela quando necessário e executa toques, gestos de deslizar e inserções de texto, passo a passo, até concluir a tarefa.
- mobilerun é gratuito? Qual é a licença?
- mobilerun é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
- mobilerun ainda é mantido?
- Manutenção ativa. O último commit de mobilerun foi em 16 de out. de 2026.
- Para que posso usar mobilerun?
- QA de apps móveis e testes de regressão com etapas de teste em linguagem simples Automatizar tarefas repetitivas em um ou vários celulares Extrair dados de apps móveis nativos que não têm API Executar fluxos de trabalho móveis por scripts ou agendamentos via API Python
- Como instalar mobilerun?
- Instale a CLI com uv: uv tool install mobilerun Instale o app Portal e ative o serviço de acessibilidade no seu dispositivo Android (é necessário ter ADB e a depuração USB ativados): mobilerun setup Configure seu provedor de LLM: mobilerun configure Execute sua primeira tarefa em linguagem natural: mobilerun run "Open settings and turn on dark mode"
- Onde consigo mobilerun?
- O código-fonte e as instruções de instalação estão no GitHub: https://github.com/droidrun/mobilerun
Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.
Projetos relacionados
Automação Android orientada por linguagem natural para assistentes de programação com IA e suítes de testes, em celulares reais ou emuladores.
12,7 mil1,5 milPythonApache-2.0Atualizado há 19 dias
SDK oficial de Python para criar servidores e clientes do Model Context Protocol que conectam aplicações com LLMs a ferramentas, dados e prompts.
24,6 mil4,3 milPythonMITAtualizado há 3 dias
Um framework de agentes que conecta humanos digitais (2.5D, 3D, mobile, PC e web) e LLMs (compatíveis com OpenAI e DeepSeek) a sistemas de negócios.
13,6 mil2,4 milPythonGPL-3.0Atualizado há 29 dias
Framework agentic de geração de vídeos que transforma uma ideia de história, um roteiro ou um romance em um vídeo com vários planos, coordenando agentes de roteiro, storyboard, personagens e geração de vídeo.
12,7 mil1,9 milPythonMITAtualizado há 20 dias
Ferramenta de linha de comando e biblioteca Python para executar prompts e conversar com modelos de linguagem de grande porte remotos ou instalados localmente.
12,6 mil1,1 milPythonApache-2.0Atualizado anteontem