espressif/esp-adf

espressif/esp-adf has 2,335 GitHub stars and 883 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-08 20:58 UTC. Last push 2026-10-29.

How these counts are measured

Espressif Advanced Development Framework for Multimedia Applications

2,335 stars 883 forks

What you can do

ESP-GMF Integration: Core media pipeline restructured using ESP-GMF (General Multimedia Framework)
Standalone Components: Functional components such as playlist can run independently
Product Services: Modular services for audio playback, video playback, battery monitoring, and more
MCP Support: Product services are callable via Model Context Protocol (MCP)

Measured star growth

in 24h: 0
in 7 days: Collecting history
in 15 days: Collecting history
in 1 month: Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

README.md

Original

Espressif Advanced Development Framework

中文版

⚠️ Important

The master branch contains the new features for ADF v3.0, which are actively developed and incompatible with previous versions. For the stable ADF v2.x version, please switch to the release/v2.x branch.

Overview

ESP-ADF (Espressif Advanced Development Framework) is Espressif’s official advanced application-layer development framework, designed to simplify the development of audio, video, and IoT products.

ADF v3.0 represents a major architectural upgrade, completely redesigned and incompatible with ADF v2.x. It focuses on product-oriented functionality, modular services, and low resource consumption.

ESP-ADF vs ESP-IDF

ESP-IDF is the base SDK for Espressif chips, offering low-level components such as OS, drivers, network stack, Bluetooth, etc.
ESP-ADF is built on top of ESP-IDF, providing high-level product-oriented services, such as audio/video playback, battery service, OTA, and more.

✅ ADF v3.0 Features

ADF v3.0 is a product-oriented development framework with significant architectural changes that are completely incompatible with previous ADF versions. Key features include:

ESP-GMF Integration: Core media pipeline restructured using ESP-GMF (General Multimedia Framework)
Standalone Components: Functional components such as playlist can run independently
Product Services: Modular services for audio playback, video playback, battery monitoring, and more
MCP Support: Product services are callable via Model Context Protocol (MCP)
Multi-Product Support: Designed for audio, video, and IoT products
Resource Efficient: Optimized for low memory and CPU usage
Multi-Language App Support: Supports development in MicroPython, Arduino, and C/C++

ADF v3.0 Block Diagram

Platform Requirements

ESP-IDF Version: v5.5.2 or later

Branch Strategy

release/v2.x: Legacy ADF implementation (v2). Receives only bug fixes and minor enhancements. See ADF v2.x Documentation for reference.
master: Development branch for ADF v3.0. Not compatible with v2.x APIs or behavior.

Documentation

ADF v3.0 documentation: Available at docs.espressif.com
ADF v2.x documentation: Available at docs.espressif.com

Roadmap

Functional Modules: e.g., Playlist, Board Manager
Service Layer: e.g., Wi-Fi Service with MCP (Model Context Protocol) support
AI Service Integration: e.g., OpenAI, Coze, etc.
Expanded set of reusable product service plugins