lamda

Establishes secure gRPC communication channels between a Python client and an Android device server, enabling structured RPC calls for device automation. The architecture uses Protocol Buffers (proto3) service definitions to define service interfaces, with the client maintaining persistent connections and session state. This design abstracts away low-level ADB complexity and provides type-safe, versioned API contracts between client and device.

Inspects the Android accessibility tree (UI hierarchy) to locate elements by text, resource ID, class type, or XPath patterns, then executes touch interactions (click, long-press, swipe) on those elements. The framework parses the accessibility hierarchy returned by UIAutomator2 or similar services, builds an in-memory tree representation, and maps user-specified selectors to concrete element coordinates for interaction. This approach enables reliable element targeting even when layouts change, as long as accessibility attributes remain stable.

Configures OpenVPN connections and SSH tunnels on the Android device to enable secure remote access and network isolation. The framework manages VPN configuration files, SSH key setup, and connection lifecycle, allowing automation scripts to route device traffic through VPN or establish secure tunnels to remote servers. This enables testing of VPN-dependent apps and secure communication scenarios.

Reads and modifies SELinux (Security-Enhanced Linux) policies on the Android device to enable or disable security restrictions. The framework provides APIs to query current SELinux mode, modify policies for specific processes or files, and temporarily disable SELinux for testing purposes. This enables security testing and bypassing of security restrictions for authorized penetration testing.

Integrates with Magisk framework to install and manage system-level modifications on the Android device, enabling root access, module installation, and system behavior customization without modifying the system partition. The framework provides APIs to query installed Magisk modules, install new modules, and manage Magisk settings. This enables advanced customization and testing scenarios that require system-level changes.

Integrates with Xposed framework to install and manage Xposed modules for system-wide method hooking and behavior modification. The framework provides APIs to query installed Xposed modules, manage module activation, and interact with Xposed-based instrumentation. This enables deep system-level testing and behavior modification on devices running Xposed.

Installs, launches, stops, and uninstalls Android applications programmatically, with fine-grained control over permissions and instrumentation hooks. The framework wraps ADB package manager commands and Android Activity Manager APIs, allowing scripts to grant/revoke permissions, enable/disable components, and inject instrumentation for monitoring app behavior. This enables automated app deployment, permission testing, and behavioral analysis without manual device interaction.

Intercepts and modifies HTTP/HTTPS traffic from the Android device using an integrated MITM (Man-in-the-Middle) proxy, allowing inspection of request/response payloads, header manipulation, and response injection. The framework configures the device's global proxy settings or per-app proxy rules, routes traffic through a proxy server (e.g., mitmproxy), and exposes APIs to inspect, filter, and modify traffic in real-time. This enables security testing, API contract validation, and behavioral analysis without modifying app code.

Injects JavaScript code into running Android processes using the Frida instrumentation framework, enabling real-time hooking of Java methods, native functions, and system calls. The framework manages Frida server lifecycle on the device, compiles and injects user-provided scripts, and exposes APIs to intercept method calls, modify arguments/return values, and monitor execution flow. This enables deep behavioral analysis, security testing, and reverse engineering without modifying app source code or APK.

Executes arbitrary shell commands on the Android device with root privileges, and reads/writes system properties via the property service. The framework wraps ADB shell execution and Android property APIs, allowing scripts to run system utilities, modify device settings, and access low-level system state. This enables device configuration, system behavior testing, and advanced automation scenarios that require privileged access.

Captures full-screen or region-specific screenshots from the Android device and returns them as image files or binary data. The framework uses Android's ScreenCap service or similar mechanisms to efficiently capture the framebuffer, optionally overlaying UI element bounds or accessibility hierarchy information. Screenshots can be used for visual assertions, debugging, or as input to OCR/image analysis pipelines.

Reads, writes, and deletes files on the Android device's file system, including app-private directories, cache, and shared storage. The framework uses ADB file transfer (push/pull) or direct file system APIs with appropriate permission handling, enabling data extraction for analysis, test data setup, and app state inspection. This allows automation scripts to access app databases, configuration files, and logs without requiring app-level APIs.

Manages connections to multiple Android devices simultaneously, enabling parallel test execution and device pool management. The framework maintains a registry of connected devices, provides APIs to allocate/deallocate devices from a pool, and coordinates test execution across devices. This enables large-scale test automation and device farm scenarios without manual device management.

Allows extending LAMDA functionality through a plugin architecture supporting HTTP extensions and MCP (Model Context Protocol) servers. The framework provides hooks for registering custom services, exposing them via HTTP or MCP interfaces, and integrating with external tools and AI agents. This enables third-party developers to add domain-specific automation capabilities and integrate LAMDA with AI-powered workflows.