lamda

# **FIRERPA Android** ｜ Automação com IA

<img src="https://raw.githubusercontent.com/firerpa/lamda/HEAD/image/logo.svg" alt="FIRERPA" width="200" align="right" />

<p>
<img src="https://img.shields.io/badge/python-3.6+-blue.svg?logo=python&amp;labelColor=yellow" />
<img src="https://img.shields.io/badge/android-6.0+-blue.svg?logo=android&amp;labelColor=white" />
<img src="https://img.shields.io/badge/root/non--root--mode-green.svg?logo=android&amp;labelColor=black" />
<img src="https://img.shields.io/badge/Built--in%20MCP-000.svg?logo=anthropic&amp;labelColor=black" />
</p>

<h6>Um framework de automação Android completo que combina serviços no dispositivo, agentes prontos para IA e invocação extensível de ferramentas.</h6>

<p align="left"><a href="https://device-farm.com/docs/en/">Documentação</a> | <a href="https://device-farm.com/docs/zh/">使用文档</a> | <a href="https://device-farm.com/contact#telegram">TELEGRAM</a> | <a href="https://device-farm.com/contact#QQ">Grupo QQ</a> | <a href="https://github.com/firerpa/skills">SKILLS</a> | <a href="https://device-farm.com/llms-full.txt">llms-full.txt</a> | <a href="https://github.com/firerpa/lamda/blob/10/README.zh.md">中文版本</a></p>

FIRERPA é uma **plataforma de controle de dispositivos Android tudo-em-um**. O servidor é executado diretamente no dispositivo **sem dependências extras de tempo de execução**; **suporta várias gerações de Android** e funciona **com ou sem root**. No lado do PC, a biblioteca cliente Python orquestra automação de UI, operações remotas, captura de tráfego, engenharia reversa baseada em Hook, proxy de rede, rede distribuída, agentes de IA e **MCP** através de um único serviço e API. Comparado com juntar Appium, mitmproxy, frida-server, adb, uiautomator2 e scripts e ferramentas de operação ad-hoc, o FIRERPA oferece **uma única fonte de capacidades, configuração unificada, fluxos de trabalho conectados e uma pilha construída para uso em múltiplos dispositivos, de longa duração e em produção**.

## Área de Trabalho Remota e Transmissão ao Vivo

A FIRERPA fornece uma área de trabalho remota baseada em navegador: visualize e controle o dispositivo em tempo real sem instalar um cliente dedicado no PC, em LAN ou através de redes. A transmissão suporta tanto **MJPEG** quanto **H.264**, com backends de codificação por software e hardware. A taxa de quadros (até 60fps), escala de resolução, bitrate e qualidade podem ser ajustados de acordo com a capacidade do dispositivo e as condições da rede — reduzindo a largura de banda e melhorando a suavidade em links fracos. **WebRTC** também é suportado, com servidores STUN/TURN configuráveis para melhor travessia NAT e menor latência ponta a ponta em configurações públicas ou entre regiões.

A área de trabalho remota suporta **acesso simultâneo de múltiplos usuários** para depuração colaborativa, demonstrações e treinamento. Compartilhamento de **área de transferência bidirecional** e **áudio ao vivo** (Android 10+) estão incluídos, junto com um terminal integrado, uploads por arrastar e soltar e navegação e downloads de arquivos baseados no navegador — tudo em uma única porta. A **inspeção visual de layout** integrada destaca elementos, suporta navegação por Tab, mostra coordenadas e valores RGB e exporta a árvore de layout XML, para que você possa validar seletores e lógica de automação na mesma UI, encurtando o ciclo da tela ao script.

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/251d9eed35540aadebab75dec6f3a59aaeb7c4b5f93ee39e8f74dcb8b0cfa68d.gif" alt="demo" width="100%">
</p>

A área de trabalho remota e RPC suportam **TLS ponta a ponta** e controle de acesso por certificado de serviço, com senhas de login opcionais personalizadas no WebUI para reduzir a exposição em redes públicas. As capacidades da área de trabalho remota também podem ser incorporadas em seus próprios aplicativos web via WebSocket (vídeo ao vivo, toque, terminal, teclas, etc.), com `allow_origin` para integração entre origens — adequado para comercializar o controle de dispositivos reais.

## Automação de UI

O FIRERPA fornece um sistema de automação completo baseado em seletores: texto, resourceId, descrição, scrollable e outros correspondentes comuns, além de encadeamento **filho/irmão** para elementos duplicados, hierarquias profundas ou controles sem atributos distintivos. No nível do elemento: capturas de tela, aguardar aparecimento/desaparecimento, coordenadas de canto/centro, verificações de existência, entrada Unicode, deslizes graduais, rolagem por fling, rolar até o fim e mais. Ele pode **coexistir com outros serviços de acessibilidade** no Android 8.0+ e melhora a descoberta de nós WebView para aplicativos híbridos.

O **UI Watcher** escuta mudanças na UI em tempo real e executa cliques, eventos de tecla ou contadores quando as condições correspondem — útil para dispensar automaticamente acordos, prompts de atualização, anúncios e outras interrupções. Várias condições de seletor e habilitação/desabilitação por evento são suportadas; telas transitórias podem ser contadas.

**Virtual Display** é um diferencial: crie telas de fundo isoladas no dispositivo e execute aplicativos e automação ali **sem afetar a tela principal** — por exemplo, resposta automática em uma tela virtual enquanto você usa o telefone normalmente. A API de tela virtual espelha a API principal do dispositivo (`d.xxx` → `vd.xxx`); Watchers podem ser limitados a uma tela virtual. O WebUI suporta **visualização e troca de múltiplas telas** na área de trabalho remota — ideal para tarefas em segundo plano, trabalho paralelo e automação com supervisão humana mais máquina.

Para cenários sem uma árvore de visualização padrão (jogos, UI desenhada personalizada), o FIRERPA oferece **OCR** e **correspondência de imagem**. O OCR suporta paddleocr, easyocr e backends HTTP personalizados; em clusters, o reconhecimento pode ser executado centralmente em vez de carregar modelos em cada PC, com aceleração GPU e correspondência de texto flexível. A correspondência de imagem é executada **no dispositivo** (template ou SIFT), sem consumir recursos do PC; SIFT é robusto a rotação, escala e iluminação. **Multi-touch** suporta gravação, repetição, construção programática e persistência binária para gestos complexos e pressão.

Arquiteturalmente, o FIRERPA usa um modelo cliente/servidor — melhor para **agendamento centralizado, versionamento e controle de frota** do que executores de script no dispositivo como AutoJS; mais leve que Appium; **mais estável que uiautomator2 em cenários com múltiplos dispositivos**. A documentação o posiciona como um **superconjunto funcional** das pilhas comuns de automação Android — automação, captura, Hook e operações podem ser encadeadas em código em uma plataforma sem trocar de ferramentas.

## Captura de Pacotes e MITM

O FIRERPA oferece **captura MITM com um clique**: instalação automática do CA raiz do sistema, configuração de proxy, tratamento de diferenças de versão do Android e restauração automática da rede ao sair — sem alternância manual de certificado ou proxy. Captura global, captura por pacote, edição ao vivo de requisição/resposta, mitmweb compartilhado e proxy HTTP upstream para **tráfego internacional** são suportados. O **downgrade QUIC** integrado reduz a interferência do QUIC. A captura ainda funciona quando PC e dispositivo compartilham apenas uma única porta FIRERPA (por exemplo, conexão ADB ou encaminhamento frp).

Além de scripts com um clique, o MITM é totalmente **orientado por API**: instalar/desinstalar CAs de sistema compatíveis com mitmproxy, Fiddler, Charles, etc.; incorporar captura em pipelines de automação junto com etapas de UI e hooks Frida. Um **startmitm.exe** para Windows está disponível sem instalação do Python.

## Rede, Proxy e Conectividade

No dispositivo, o FIRERPA fornece suporte completo a proxy: **HTTP / HTTPS / SOCKS5 / Shadowsocks** (várias cifras), proxy por aplicativo (incluindo clones de múltiplos usuários), proxy DNS, proxy UDP, desvio de LAN, coexistência com OpenVPN e **conexão automática** a proxies configurados na inicialização. Os proxies suportam **IPv6 e UDP** para redes complexas.

**Proxy de ponte HTTP do dispositivo (tunnel2)** fornece capacidade de proxy reverso: aponte o proxy HTTP do seu PC ou navegador para o telefone e o tráfego é encaminhado através da saída de rede do telefone; o IP de saída corresponde ao telefone. Wi‑Fi ou celular (rmnet) podem ser escolhidos como interface de saída — útil para depuração conjunta, aplicativos internacionais e pools de IP de múltiplos dispositivos.

Um **cliente OpenVPN** integrado suporta certificado, nome de usuário/senha e autenticação mista, juntamente com proxy do sistema; uma **imagem Docker OpenVPN** e geradores de configuração produzem código do lado do dispositivo e configurações de inicialização automática. Um **cliente frp** integrado encaminha serviços do dispositivo para um servidor público via `fwd.*`, com criptografia e TLS.

**Descoberta mDNS** permite acesso `{device_id}.local` à área de trabalho remota e outros serviços, com metadados TXT opcionais (modelo, ABI, ID do dispositivo) para descoberta de frota em LAN.

## Frida e Engenharia Reversa

O FIRERPA **inclui a versão mais recente do Frida** — sem necessidade de frida-server separado. Use as ferramentas do Frida a partir do terminal da área de trabalho remota sem `-U`, `-H`, etc. Patches de ocultação integrados (open-source e próprios) são mantidos contra detecção; as conexões usam autenticação por token através da porta FIRERPA. Patches do objection e auxiliares java-bridge do Frida 17.x facilitam a migração.

**Scripts Frida persistentes** reinjetam após falha ou saída do aplicativo; persistência YAML offline com monitoramento de diretório e recarga a quente. Frida RPC mapeia para **métodos Python** e chamadas remotas **HTTP + JSON-RPC 2.0** em threads JVM, UI principal ou JS puro. Dados `emit` do script podem ir para **HTTP / Redis / RabbitMQ (MQTT)** com metadados do dispositivo/aplicativo, compressão zlib, retentativas HTTP e TLS MQTT.

## ADB, SSH e Terminal Integrado

O FIRERPA inclui um **ADB integrado autônomo** — ADB sem fio de alto privilégio **sem ativar as Opções do Desenvolvedor do sistema**, útil quando aplicativos detectam o modo desenvolvedor. Módulos Magisk podem pré-instalar `adb_keys` para autorização padrão. **SSH** integrado mais `ssh.sh` / `scp.sh` para shell remoto e transferência de arquivos.

O **terminal integrado** vem com strace, ltrace, tcpdump, scapy, fsmon, frida-tools, MemDumper e pilhas Python como Crypto, cv2, unicorn, capstone, keystone, redis e grpc. sqlite3 suporta **wxsqlite / sqlcipher / sqlcrypto** para ler bancos de dados criptografados de aplicativos como WeChat, WeCom e clientes da família Alibaba. Um ambiente em toda a área de trabalho remota, SSH e ADB — analise e controle no dispositivo com menos deslocamento para o PC.

## Gerenciamento Distribuído e de Múltiplos Dispositivos

**Plataforma FIRERPA StarLink (Hub + hub-bridge)** fornece acesso centralizado a múltiplos dispositivos para dispositivos locais e remotos com gerenciamento unificado e acesso **P2P** — ideal para “dispositivo em casa, operador em outro lugar” e colaboração entre vários dispositivos. hub v3 usa **SAPI** para requisições unificadas a dispositivos locais e remotos. Além do Hub, **encaminhamento frp** e **malha OpenVPN** também são suportados como opções auto-hospedadas, com documentação completa e suporte a Docker.

Desde a versão 9.0, **conectividade P2P Bridge** entre pares e um **sistema de tarefas distribuídas integrado** são suportados; desde a 7.50, um serviço de assinatura de rede está disponível para que você não precise auto-hospedar frp/OpenVPN. Projetado para pools de telefones em nuvem, fazendas de dispositivos e clusters de emuladores — operação **em lote, sempre ligada, sem supervisão**.

## IA / MCP / Agente

O FIRERPA inclui um **servidor MCP** (`/mcp/`) em **streamable-http**, com chamadas de ferramenta, leituras de recursos, prompts, notificações de progresso e logs — compatível com **Claude, Cursor** e outros clientes MCP. As extensões MCP oficiais ficam em `~/modules/extension`.

O **comando `agent`** integrado comanda o dispositivo em **linguagem natural** através de qualquer API compatível com OpenAI com chamadas de ferramenta, incluindo modo **visão**, além de um **executor de tarefas semânticas OpenAI**. Combine com **crontab** para tarefas de IA agendadas em dispositivos reais.

<p align="center">
<img src="https://assets.kitploit.com/production/public/readmes/7312/92639519cee4c07efbe1da1030a4107808841995e15962977a1364f22df70248.gif" alt="MCP" width="100%">
</p>

## Controle do Sistema e Extensões

**Mais de 160 APIs Python** cobrem operações de aplicativos, E/S de arquivos, execução de comandos, status do dispositivo, WiFi, proxy, OpenVPN, desligamento/reinicialização, logs de serviço e mais. `setprop` pode escrever propriedades somente leitura **`ro.*`**; APIs de Configurações ajustam brilho, modo desenvolvedor, etc.; **SELinux** criação de domínio, modo permissivo e permitir/negar granular. APIs completas de múltiplas instâncias de aplicativos, conceder/revogar permissões silenciosamente, iniciar atividades não exportadas, desabilitar aplicativos para economizar recursos.

**Correção binária** (curingas hex, caminhos glob, dryrun) e métricas de tempo de execução para disco, bateria, CPU, memória e E/S de rede. Reprodução de WAV e APIs de armazenamento interno. **tflite-runtime** no dispositivo com computação acelerada por hardware para inferência na borda.

Um **ambiente Debian virtual** executa Debian completo com apt — compile BPF, implante OpenSSH, instale dependências Python arbitrárias além dos limites do terminal integrado.

## Implantação, Segurança e Governança

Implante via **APP com um clique** (root ou Shizuku), **inicialização automática do módulo Magisk**, extração manual ou **integração ROM** — projetado para operação **24/7**. O APP pode **gerar automaticamente certificados de serviço**; zips Magisk podem incluir propriedades, lamda.pem e adb_keys. **Configuração de serviço INI** centraliza porta, WebUI, certificados, OpenVPN, gproxy, frp, tunnel2, cron, sshd, adb, mdns, etc.; WebUI oferece edição visual, texto bruto e Recarregar Serviço, além de carregamento remoto de arquivos de configuração.

Identidades root e shell; arm64, armeabi-v7a, x86, x86_64; dispositivos reais, emuladores (LDPlayer, Nox, etc.), Redroid, WSA, AVD, telefones em nuvem. Caminhos de desinstalação limpos. **Bloqueio exclusivo de API** evita contenção de clientes. Política de privacidade: nenhuma coleta de contatos, SMS, localização, etc.; **licenciamento offline** suportado.

## Ferramentas e Evolução

**Mais de seis anos** de desenvolvimento contínuo, com correções de compatibilidade para Android 14–16 e trabalho contínuo em área de trabalho remota para múltiplos usuários, APIs de toque padronizadas, MCP, versões e ocultação do Frida, proxy IPv6/UDP, P2P Bridge e tarefas distribuídas.

A força do FIRERPA não é nenhum recurso isolado, mas integrar **área de trabalho remota (WebRTC/H.264/múltiplos usuários), automação de UI (tela virtual, Watcher, OCR, correspondência de imagem, multi-toque), captura com um clique, Frida integrado, proxy completo e VPN/frp/P2P, ADB/SSH/terminal integrado, IA MCP/Agente, controle em nível de sistema, Debian virtual, KV persistente e criptografia de scripts** em um único dispositivo Android, um serviço e um cliente Python — para que testes de segurança, análise de conformidade, recuperação de protocolo, gerenciamento de frota e automação sejam executados em **um pipeline** em vez de muitas ferramentas coladas.