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.30.0
Last release 7 days ago
12 Nov 2026
Ships on a steady schedule
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
451 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
Sync protobuf changes for fixed-size BLE advertisement arrays (#1258) @bdraco
Remove deprecated unique_id field from API protocol (#1242) @bdraco
<details> <summary>4 changes</summary>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Reduce binary size by conditionally compiling protocol fields (#1250) @bdraco
Regenerate proto files with protobuf6 (#1249) @bdraco
Sync protobuf changes from esphome (#1247) @bdraco
Fix CameraImageResponse missing base class and sync USE_CAMERA ifdef (#1244) @bdraco
<details> <summary>3 changes</summary>
Add device_id field to all StateResponse messages for multi-device entity tracking (#1237) @bdraco
<details> <summary>2 changes</summary>
Do not create zeroconf listeners when name is an IP address (#1234) @bdraco
<details> <summary>5 changes</summary>
Fix DeviceInfo round-trip serialization after areas/devices fields additions (#1229) @bdraco
[API] Sub devices and areas (#1146) @dala318
Rebuild protobuf files with protobuf5 (#1227) @bdraco
<details> <summary>3 changes</summary>
Add intent progress to voice assistant enum (#1221) @synesthesiam
Add missing base class for EventResponse (#1220) @bdraco
Implement common base class for entity protobuf messages (#1219) @bdraco
Ensure third party callbacks on BLE notify do not cause disconnect (#1212) @bdraco
Add streaming log parser (#1209) @bdraco
Optimize parse_log_message for single case (#1208) @bdraco
<details> <summary>2 changes</summary>
Split connection process to enable earlier zeroconf listening (#1205) @bdraco
<details> <summary>6 changes</summary>
Fix race condition with internal message handlers registration (#1195) @bdraco
<details> <summary>3 changes</summary>
Fix old light enum value (#1190) @jesserockz
Add benchmark for most frequent noise message sizes (#1186) @bdraco
<details> <summary>2 changes</summary>
Fast nonce implementation for encryption (#1181) @bdraco
<details> <summary>6 changes</summary>
Bluetooth proxy: get state and set mode (#1170) @jesserockz
<details> <summary>6 changes</summary>
Ensure set_cached_name_if_unset accepts subclassed str (#1157) @bdraco
Replace get_event_loop with get_running_loop (#1156) @bdraco
Add check for unexpected MAC address for noise protocol (#1149) @bdraco
<details> <summary>2 changes</summary>
Raise EncryptionPlaintextAPIError when noise is selected but remote protocol is plaintext (#1138) @bdraco
<details> <summary>3 changes</summary>
Raise EncryptionHelloAPIError when connection drops during encrypted hello (#1132) @bdraco
<details> <summary>7 changes</summary>
Add IPv6 support to the reconnect logic zeroconf listener (#1121) @bdraco
<details> <summary>2 changes</summary>
Rework process_packet to handle the common case of a single callback (#1117) @bdraco
No changes from 2.5.0; release due to failed release of 2.5.0
Avoid protobuf lookup to find MergeFromString (#1100) @bdraco
Reduce size of wheels (#1098) @bdraco
<details> <summary>2 changes</summary>
Also catch OSError when trying to set TCP_QUICKACK (#1093) @badrpc
Add bluetooth_mac_address to DeviceInfo model (#1090) @bdraco
bluetooth_mac_address to DeviceInfo model (#1090) @bdracoAdd bluetooth mac address to DeviceInfoResponse (#1080) @bdraco
<details> <summary>3 changes</summary>
Add the ability to cancel subscribe_logs (#1086) @bdraco
<details> <summary>2 changes</summary>
Fix discovery display when values are unexpectedly empty (#1082) @bdraco
Resolve hosts in parallel (#1072) @bdraco
Add manylinux armv7l wheels (#1070) @bdraco
Build armv7l wheels (#1069) @bdraco
<details> <summary>11 changes</summary>
Include Bluetooth connection slot allocations in connections free message (#1038) @bdraco
<details> <summary>4 changes</summary>
Migrate to using native ARM runners for wheel builds (#1031) @bdraco
<details> <summary>19 changes</summary>
Bump protobuf requirement to >=4 (#1007) @bdraco
<details> <summary>3 changes</summary>
Wrap PACK_NONCE in staticmethod (#1002) @bdraco
<details> <summary>2 changes</summary>
Ensure BLE device is disconnected after unhandled connect exception (#999) @bdraco
<details> <summary>6 changes</summary>
Implement zerocopy writes (#990) @bdraco
<details> <summary>18 changes</summary>
Change wake word id to string (#960) @synesthesiam
<details> <summary>2 changes</summary>
Add get/set/config messages for voice assistant (#956) @synesthesiam
Bump async-interrupt to >=1.2.0 (#952) @bdraco
MediaPlayerSupportedFormat (#948) @jesserockzAvoid a dict lookup and int conversion to process every packet (#946) @bdraco
<details> <summary>4 changes</summary>
Try to set TCP_QUICKACK where support for that option is available (#932) @nkinnan
Add MediaPlayerSupportedFormat (#925) @synesthesiam
Dont call subscription callback when we want single state only (#930) @jesserockz
Adjust subscribe_home_assistant_states to allow separate callback (#928) @jesserockz
subscribe_home_assistant_states to allow separate callback (#928) @jesserockz<details> <summary>2 changes</summary>
Add once flag to SubscribeHomeAssistantStateResponse (#923) @jesserockz
once flag to SubscribeHomeAssistantStateResponse (#923) @jesserockz<details> <summary>5 changes</summary>
Ruff updates (#915) @jesserockz
Bump cryptography to 43.0.0 and chacha20poly1305-reuseable to 0.13.2 (#910) @bdraco
<details> <summary>13 changes</summary>
remove name from test auto_spec to workaround py3.12.4 breaking changes (#890) @bdraco
<details> <summary>5 changes</summary>
Update Entities (#882) @jesserockz
<details> <summary>3 changes</summary>
One column per quarter.