Architecture Overview

Understanding Sandroid’s architecture helps with development and customization.

Core Components

Toolbox (Central Orchestrator)

  • Configuration management

  • Device communication coordination

  • Analysis result aggregation

ActionQ (Workflow Management)

  • Analysis workflow orchestration

  • Module coordination

  • Queue management

ADB Interface

  • Android Debug Bridge communication

  • Device command execution

  • File transfer operations

Module Architecture

Analysis Modules (sandroid.analysis)

  • Inherit from DataGather base class

  • Follow consistent interface pattern

  • Modular and extensible design

Feature Modules (sandroid.features)

  • Inherit from Functionality base class

  • Provide enhanced capabilities

  • Independent operation

Configuration System

  • Pydantic-based validation

  • Multiple format support

  • Environment variable integration

Development Standards

When implementing new modules or extending existing ones, follow the comprehensive Coding Guidelines which cover architectural patterns, testing standards, and Sandroid-specific conventions.

For detailed API information, see the API documentation.