ESP-Brookesia Programming Guide
Overview
ESP-Brookesia is a full-stack development platform for AIoT and HMI products. It organizes hardware abstraction, service framework, runtimes, GUI, system framework, app components, and AI capabilities as ESP-IDF components so products can compose and reuse platform capabilities as needed.
The overall ESP-Brookesia architecture is shown below:
Main Architecture Layers
Hardware Abstraction: hides platform and hardware differences, unifies device access, and supports ESP devices and PC simulation.
Service Framework: unifies service registration, function calls, event publish/subscribe, and MCP / Agent capability connections.
Runtime and GUI: supports multi-runtime apps and the JSON UI-driven GUI model.
System Framework: provides the product-level system framework that integrates GUI, Runtime, services, and app lifecycle.
App Ecosystem: covers third-party app supply, upload and publish, device-side distribution, and installation.
Main Architecture Features
Hardware Decoupling: HAL and PC simulation reduce the impact of hardware differences on upper-layer apps and systems.
App Development Efficiency: service-based design, multi-runtime support, and declarative GUI improve app development and validation efficiency.
Productization and Ecosystem: the system and app frameworks combine with the app-store mechanism to support scalable product delivery.
AI-Assisted Development and App Ecosystem
AI Development Validation Loop: AI Workflow and PC Validation form a development validation loop. Developers review, tune, and supplement the result to generate a publishable app.
Publishing and Distribution Flow: the app then moves through Upload & Publish, App Store, and Device Runtime to complete publishing, discovery, download, installation, and execution.







