NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI, #4686 most downloaded on PyPI
Python API for interacting with ESPHome devices.
Latest stable
46.28.0
Last release 9 days ago
05 Nov 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 58 of the last 60 stable releases
1 version withdrawn
withdrawn after publishing
8 years old
449 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Lower cryptography requirement to 47+ (#1634) @bdraco
Add missing mapping for water_heater in COMPONENT_TYPE_TO_INFO (#1632) @tronikos
<details> <summary>8 changes</summary>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Mark high-volume proxy messages as speed_optimized (#1620) @bdraco
<details> <summary>5 changes</summary>
Add 48-bit MAC address varint fast path for BLE advertisements (#1614) @bdraco
<details> <summary>4 changes</summary>
Add opt-in plaintext fallback for log streams in ReconnectLogic (#1607) @bdraco
[radio_frequency] Add radio_frequency entity type support (#1564) @kbx81
<details> <summary>4 changes</summary>
Add opening and open lock states to protobuf (#1599) @egormanga
LockState::UNLOCKED duplicate value (#1601) @egormangaAdd temperature unit to climate and water_heater (#1600) @jhenkens
Expose the bound APIClient event loop with .loop (#1598) @puddly
APIClient event loop with .loop (#1598) @puddlySilence log_runner warning for CameraState (#1593) @bdraco
Fix log_runner info lookup colliding across entity types (#1590) @bdraco
<details> <summary>6 changes</summary>
Add speed_optimized to SubscribeLogsResponse (#1579) @bdraco
Add speed_optimized message option to api_options.proto (#1578) @bdraco
Stop mDNS records from thrashing an in-flight connect attempt (#1576) @bdraco
Preserve parent task cancellation state in connect exception handling (#1573) @bdraco
<details> <summary>2 changes</summary>
Revert "Bump pypa/gh-action-pypi-publish from 1.13.0 to 1.14.0" (#1568) @bdraco
Sync api.proto with esphome max_data_length and force annotations (#1563) @bdraco
Add missing max_data_length to number api.proto (#1561) @bdraco
Bump mypy from 1.19.1 to 1.20.0 (#1552) @[dependabot[bot]]
Nothing published for this version
Add max_value proto field option (#1559) @bdraco
<details> <summary>5 changes</summary>
[logging] Fix climate state (#1550) @kbx81
<details> <summary>2 changes</summary>
Add client-side entity state change logging to log runner (#1547) @bdraco
Mark all key fields as force (#1542) @bdraco
Increase noise handshake timeout from 30s to 60s (#1540) @bdraco
Fix lookup of top-level IANA timezone keys like UTC and GMT (#1538) @bdraco
[serial_proxy] Add awaitable serial proxy subscribe/unsubscribe responses (#1537) @kbx81
<details> <summary>2 changes</summary>
Remove unreachable guard in _skip_tz_name (#1534) @bdraco
Expose SerialProxyRequestResponse (#1524) @puddly
SerialProxyRequestResponse (#1524) @puddly[serial_proxy] Add SerialProxyRequestResponse (#1523) @kbx81
Add force encoding option to protobuf option (#1522) @bdraco
Add rpc entry for bluetooth_set_connection_params (#1521) @bdraco
Force release drafter (#1520) @bdraco
<details> <summary>12 changes</summary>
Add DEFROSTING to ClimateAction (#1506) @lyubomirtraykov
Add timezone parser (#1505) @bdraco
<details> <summary>8 changes</summary>
Add WaterHeaterFeature class for ESPHome (#1493) @tronikos
<details> <summary>5 changes</summary>
Add bluetooth_gatt_stop_notify and auto-cleanup notify callbacks on disconnect (#1487) @bdraco
<details> <summary>2 changes</summary>
Sync api.proto from ESPHome (#1482) @bdraco
[infrared] New component/entity type (#1477) @kbx81
Add packed buffer support to protobuf (#1480) @kbx81
<details> <summary>2 changes</summary>
Add missing water_heater entity command mappings (#1476) @bdraco
Adding API Password deprecation information (#1382) @generalmat82
Only compute object_id for API version 1.14+ (#1471) @bdraco
Bump API minor version to 14 (1.14) (#1470) @bdraco
Delegate list_entities_services to device_info_and_list_entities when not cached (#1469) @bdraco
Ensure list_entities_services always fills missing object_ids (#1468) @bdraco
Add version parameter to build_unique_id (#1466) @bdraco
Add water_heater component (#1459) @dhoeben
Migrate to zero-copy for HomeAssistantStateResponse (#1461) @bdraco
<details> <summary>2 changes</summary>
Update benchmarks to use Python 3.14 (#1427) @bdraco
<details> <summary>7 changes</summary>
Replace retired macos-13 with macos-15-intel to fix wheel builds (#1447) @bdraco
Implement zero copy for select calls (#1445) @bdraco
Change execute_service to be async to handle timeouts internally (#1443) @jesserockz
execute_service to be async to handle timeouts internally (#1443) @jesserockzAdd device defined action responses (#1436) @jesserockz
<details> <summary>4 changes</summary>
Add vscode tasks to run tests (#1437) @jesserockz
Sync light effects protobuf to avoid heap allocations (#1434) @bdraco
USE_API_SERVICES to USE_API_USER_DEFINED_ACTIONS (#1429) @jesserockz<details> <summary>10 changes</summary>
Store event_types in flash instead of RAM (#1419) @bdraco
<details> <summary>3 changes</summary>
Store custom climate presets and fan modes in flash instead of RAM (#1415) @bdraco
Change fan preset modes to std::vector (#1413) @bdraco
Store select options in flash instead of RAM (#1411) @bdraco
<details> <summary>5 changes</summary>
One column per quarter.