firerpa/lamda

Android Full-Stack Device Control Platform: WebRTC/H.264 remote desktop, UI/OCR/image-matching automation, one-click MITM, built-in Frida, proxy/VPN/frp/P2P networking, MCP/Agent, 160+ APIs, designed for multi-device clusters and engineered deployments.

What it solves

FIRERPA는 포괄적인 Android 디바이스 제어 플랫폼으로, Appium, mitmproxy, Frida, ADB와 같은 여러 파편화된 도구를 조합할 필요를 없애줍니다. UI 자동화, 보안 테스트, 디바이스 관리를 하나의 통합 API와 서비스로 처리합니다.

How it works

클라이언트‑서버 아키텍처를 사용하며, 서버는 Android 디바이스에서 직접 실행됩니다(루트 권한 여부에 관계없이). 추가 런타임 종속성이 없습니다. PC의 Python 클라이언트 라이브러리가 디바이스를 오케스트레이션합니다. 시스템은 다음과 같은 고수준 기능을 통합합니다:

  • Remote Access: WebRTC, MJPEG 또는 H.264를 이용한 브라우저 기반 원격 데스크톱으로 실시간 제어 제공.
  • UI Automation: 셀렉터 기반 요소 상호작용 시스템에 OCR 및 이미지 매칭을 보조하여 비표준 UI를 처리하고, 백그라운드에서 자동화를 실행할 수 있는 "Virtual Displays" 제공.
  • Network Control: 내장 MITM 캡처, 전체 프록시 지원(HTTP/SOCKS5) 및 VPN/frp/P2P 연결을 통한 원격 접근.
  • Reverse Engineering: 런타임 조작을 위한 Frida 번들 및 strace, tcpdump 등 도구가 포함된 터미널 제공.
  • AI Integration: MCP(Model Context Protocol) 서버와 자연어 agent 명령을 제공해 LLM이 비전 및 툴 호출을 통해 디바이스를 제어하도록 함.

Who it’s for

  • QA 및 자동화 엔지니어: 프로덕션 급 UI 테스트를 위한 안정적이고 다중 디바이스를 지원하는 프레임워크가 필요한 경우.
  • 보안 연구원: 프로토콜 복구, 리버스 엔지니어링, 트래픽 분석 수행.
  • DevOps / SRE: 클라우드 폰 풀, 에뮬레이터 클러스터, 디바이스 팜 관리.
  • AI 개발자: 실제 Android 애플리케이션과 상호작용할 수 있는 에이전트 구축.

Highlights

  • Unified Stack: UI 자동화, 패킷 캡처, Frida 훅, 원격 데스크톱을 하나의 서비스로 결합.
  • Virtual Displays: 메인 화면을 방해하지 않고 백그라운드 디스플레이에서 자동화 실행 가능.
  • One-Click MITM: 루트 CA 설치와 프록시 설정을 자동화해 즉시 트래픽 캡처.
  • AI-Ready: Claude와 Cursor와 호환되는 MCP 서버와 자연어 제어를 위한 의미론적 작업 실행기를 내장.
  • Deep System Access: Developer Options를 우회하는 독립형 ADB, 가상 Debian 환경, 읽기 전용 시스템 속성 수정 기능 포함.