---
id: idf-build-apps
version: "3.0.2"
license: unclear
license_treatment: permissive
maintenance: active
---

# idf-build-apps — Tools for building ESP-IDF related apps.

License: permissive · Maintenance: active · Downloads: 171.7K/mo

## What it is and what it does

idf-build-apps is a command-line tool and Python library for discovering and building Espressif microcontroller projects at scale. It automates the process of building ESP-IDF and ESP8266 RTOS applications across multiple configurations—different sdkconfig files and target chips—from a single project structure. Instead of manually building each combination, you define a matrix of build parameters and the tool generates all the resulting binaries in one operation.

The package works both as a CLI with three subcommands (find, build, completions) and as a library exposing find_apps and build_apps functions plus CMakeApp and MakeApp classes. It depends on common utilities like pyyaml for configuration, pydantic for validation, argcomplete for shell completion, and rich for terminal output. It supports Python 3.10 through 3.14 and is actively maintained by Espressif.

Use it for:

- Build multiple ESP32 firmware variants with different feature configurations from a single codebase.
- Automate CI/CD pipelines that need to generate binaries for multiple Espressif chip targets.
- Discover all buildable applications in a large monorepo of ESP-IDF examples or test projects.
- Generate test binaries across a matrix of sdkconfig permutations for regression testing.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Finds and builds ESP-IDF and ESP8266 RTOS projects at scale, generating multiple application binaries from a single project using different sdkconfig files and target chips.

Yes. This is a production-stable, actively maintained tool from Espressif with low install friction, no security vulnerabilities, and a permissive license. Install it if you build multiple ESP-IDF or ESP8266 RTOS applications or need to automate multi-configuration builds; skip it if you only build single, one-off projects.

## Install

pip install idf-build-apps
uv add idf-build-apps
poetry add idf-build-apps

## Installing idf-build-apps

Before you install: Low friction install with a pure-Python wheel. Active maintenance with recent commits and stable production status. Nine runtime dependencies are all common utilities (pyparsing, pyyaml, packaging, pydantic, argcomplete, rich) with no known compilation requirements.

License in practice: Permissive Apache license means you can use, modify, and distribute this tool freely in commercial and private projects without copyleft obligations.

Quickstart:

pip install idf-build-apps

idf-build-apps build -p /path/to/project --target esp32

Requires Python 3.10 or later. Expects an ESP-IDF or ESP8266 RTOS project structure with CMake or Make build recipes and optional sdkconfig files.

Verify before relying:

- Whether the tool can be used programmatically via the find_apps and build_apps functions without invoking the CLI.
- Performance characteristics when building projects with many sdkconfig variants or target combinations.

## Package facts

- License: not declared (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 171.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

esp-idf project builder, bulk build esp32 applications, cmake build automation esp, sdkconfig matrix builds, esp8266 rtos build tool, esp32-esp8266, ci-cd-automation, embedded-systems

[View on SkillFed](https://skillfed.io/packages/idf-build-apps) · [View on PyPI](https://pypi.org/project/idf-build-apps/)