esphome

library2026.6.0pypypi✓ verified 82d ago

ESPHome is a system for configuring microcontrollers via simple YAML files and controlling them remotely through home automation systems. Current version 2026.4.2, requires Python >=3.11, <3.15. Release cadence is monthly.

devops communication

pip install esphome

github ↗package ↗homepage ↗docs ↗

INSTALL

IMPORT

SIG · ESPHOME

esphome

devopspythonv2026.6.0

Install

19.6s avg

Import

—

Disk

206MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2025.7.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 165.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 19.6s · import 0.000s · 166MB

206MB installed

● package 206MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

run_command

✓ import esphome

✗ from esphome import run_command

Validate an ESPHome configuration programmatically.

import esphome import yaml # Basic configuration test config = { 'esphome': { 'name': 'test-device', 'platform': 'ESP32', 'board': 'nodemcu-32s' }, 'wifi': { 'ssid': 'MyWifi', 'password': 'mypassword' } } # Validate configuration result = esphome.run_command(['config', '--show-secrets', '-'], input=yaml.dump(config)) print(result)

esphome --version

Debug

Known issues

gotchaESPHome requires a running dashboard or manual compilation. Running pipelines without the dashboard may require special flags.

fix

Use esphome run <config.yaml> or esphome compile <config.yaml> instead of relying on dashboard.

affects: all

breakingBreaking change: In 2026.x, the JSON config format changed. Old flasher scripts may break.

fix

Update your config parsing to handle new JSON schema or use esphome.run_command('config') to get correct output.

affects: >=2026.0

deprecatedPlatformIO build system is deprecated in favor of ESP-IDF for ESP32. Using Arduino framework may cause compatibility warnings.

fix

Switch to esp-idf platform in your config or set legacy flag: esphome: { framework: { name: 'arduino', version: 'recommended' } }

affects: >=2024.12

gotchaSecrets are read from a 'secrets.yaml' file in the config directory. Programmatic usage may need to specify the path.

fix

Set SECRETS_PATH environment variable or copy secrets.yaml to working directory.

affects: all

Upgrade

Version history

2026.6.0latest on PyPI · released Jun 18, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

39 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/esphome/esphome ↗

packagehttps://pypi.org/project/esphome/ ↗

homepagehttps://esphome.io ↗

docshttps://esphome.io ↗