devtools

Esphome

Name: Esphome
Author: esphome

ESPHome is a system to control your ESP32, ESP8266, BK72xx, RP2040 by simple yet powerful configuration files and control them remotely through Home Automation systems.

11,661 stars5,614 forksC++Updated 9/8/2026100% free · open source

What it does

ESPHome lets you program ESP32/ESP8266 boards with a simple YAML file and expose the sensors/actuators directly to Home Assistant or any MQTT broker.

When to use it

•You need a low‑cost, Wi‑Fi‑enabled sensor or switch that integrates instantly with Home Assistant.
•You want to prototype hardware (temperature, motion, relays) without writing C++ firmware.
•You prefer a single source of truth (YAML) to manage multiple ESP devices at scale.

Ready-to-paste prompt

esphome run my_esp32.yaml && echo "✅ Firmware flashed – now add the 'ESPHome' integration in Home Assistant to see the new 'my_esp32' device"

Heads up: ESPHome requires Python 3.7‑3.11 and a recent version of the `esphome` package; on Windows you must install the USB driver for the ESP chip (e.g., CP210x or CH340) before flashing, otherwise `esphome run` will fail to find the device.

Saves to your device

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/1defa081-bc79-45ce-a6f6-445b597142b6 && curl -fsSL https://workflowstacks.com/api/skills/1defa081-bc79-45ce-a6f6-445b597142b6/claude-skill -o ~/.claude/skills/1defa081-bc79-45ce-a6f6-445b597142b6/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

How Esphome works

Codeflow

Free to inspect

Esphome is a very large C++ project (~574k lines across 4562 code files, plus 720 test files). Setup is light: installs like a normal app. Reading the code is optional. Last commit this month, Other license, has a test suite.

Size

Very large codebase

~574k lines · 4562 code files · days to read — use, don't read

Setup

One-command install

Installs like a normal app. Reading the code is optional.

Runs on

Python · Docker

No API keys detected

C++ 56%Python 44%

Where to start reading

1
README.md
Start here — what it does and how to install it
2
AGENTS.md
The instructions the AI actually follows
3
esphome/__main__.py
Where the program starts running
4
pyproject.toml
Dependencies and the commands it exposes
5
esphome/__init__.py
Inside esphome/ — the main logic begins here

What's in each folder

esphome/Core code — the actual logic4539 files

script/Helper scripts59 files

docker/Deployment / infrastructure26 files

tests/Tests — proof it works4333 files

.github/CI / automation (GitHub Actions)47 files

.claude/Editor / agent settings2 files

.devcontainer/Editor / agent settings2 files

.vscode/Editor / agent settings1 files

READMEHas testsDocumentedCI checksDocker readyOther licenseUpdated this month

Use with Claude

New

Skip the builder — one click puts this in Claude, Cursor, Antigravity and more.

✅ Light setup

Installs with a command or two; your AI agent can do it for you.

Try it instantly — no install

Claude Code

mkdir -p ~/.claude/skills/1defa081-bc79-45ce-a6f6-445b597142b6 && curl -fsSL https://workflowstacks.com/api/skills/1defa081-bc79-45ce-a6f6-445b597142b6/claude-skill -o ~/.claude/skills/1defa081-bc79-45ce-a6f6-445b597142b6/SKILL.md

Open in another AI app

Opens the app with this repo with the prompt ready to go — no copy-paste needed.

Connect the whole catalog (MCP)

claude mcp add --transport http workflowstacks https://workflowstacks.com/api/mcp

Adds a WorkflowStacks connector to Claude Code: search and load any skill here by chatting.

Quick Actions

Details

Creator

esphome

Language

C++