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 5 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.
Change fan preset modes to std::vector (#1413) @bdraco
Store select options in flash instead of RAM (#1411) @bdraco
<details> <summary>5 changes</summary>
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Update climate entity container types in api.proto (#1405) @bdraco
<details> <summary>2 changes</summary>
Replace enum_as_bitmask with container_pointer_no_template (#1402) @bdraco
Add enum_as_bitmask protobuf option for ColorMode encoding (#1401) @bdraco
Add Python 3.14 support and streamline CI testing (#1398) @bdraco
Mark ListEntitiesServicesResponse as fixed_vector (#1396) @bdraco
Convert HomeassistantActionRequest to use fixed_vector (#1395) @bdraco
Fix slow connections by using multicast mDNS queries for cache sharing (#1394) @bdraco
Sync protobuf changes for FixedVector support in BLE characteristics and descriptors (#1393) @bdraco
Add wifi_mac_to_bluetooth_mac() helper for ESP32 MAC address conversion (#1392) @bdraco
<details> <summary>4 changes</summary>
Reduce log spam from repeated "Successfully resolved" messages during reconnection attempts (#1387) @bdraco
<details> <summary>2 changes</summary>
Add support for getting action responses from home-assistant (#1374) @jesserockz
<details> <summary>2 changes</summary>
Loosen zeroconf pin (#1378) @bdraco
<details> <summary>4 changes</summary>
Add support for Z-Wave HomeID messages (#1371) @kbx81
Add external wake words (#1363) @synesthesiam
Fix connection timeout when password is configured but device does not support authentication (#1369) @bdraco
Fix failing tests when compiled with Cython (#1368) @bdraco
Fix segfault when send_messages is called after connection cleanup (#1366) @bdraco
Rename HomeassistantServiceResponse to HomeassistantActionRequest (#1365) @bdraco
Implement zero-copy for strings in base API calls (#1364) @bdraco
Implement zero-copy API for zwave_proxy (#1359) @bdraco
Implement zero-copy API for bluetooth_proxy writes (#1360) @bdraco
Add windows wheels (#1358) @bdraco
Add timezone parameter to APIClient to fix container timezone override issue (#1356) @bdraco
[zwave_proxy] Add Home ID to DeviceInfoResponse (#1353) @kbx81
<details> <summary>2 changes</summary>
Add port and noise_psk properties to client_base (#1352) @balloob
Add support for getting the connected_address in the client (#1351) @bdraco
[zwave_proxy] Initial support (#1349) @kbx81
<details> <summary>2 changes</summary>
Rename ConnectRequest/Response to AuthenticationRequest/Response (#1346) @bdraco
Add ifdef option to ConnectRequest/Response for passwordless optimization (#1345) @bdraco
Make GetTime messages unidirectional (remove recently added unused capability) (#1344) @bdraco
<details> <summary>3 changes</summary>
Add timezone to GetTimeResponse (#1340) @bdraco
<details> <summary>3 changes</summary>
Fix scope_id in IPv6Sockaddr for "address%iface" (#1338) @fphammerle
Fix DNS resolution to succeed when at least one hostname resolves (#1334) @bdraco
Improve .local resolution compatibility with parallel DNS fallback (#1333) @bdraco
<details> <summary>5 changes</summary>
Add configured_mode to BluetoothScannerStateResponse (#1327) @bdraco
<details> <summary>5 changes</summary>
Add combined device_info_and_list_entities method to reduce connection latency (#1317) @bdraco
<details> <summary>2 changes</summary>
Fix subscribe_home_assistant_states_and_services with Cython (#1312) @bdraco
Add unified subscription method to reduce connection latency (#1311) @bdraco
<details> <summary>2 changes</summary>
Sync API changes for fixed array BLE advertisements (#1307) @bdraco
Drop support for pre-V3 Bluetooth connection methods (#1304) @bdraco
<details> <summary>2 changes</summary>
Fix TypeError when addresses parameter contains Estr objects (#1300) @bdraco
<details> <summary>2 changes</summary>
Sync areas and devices api.proto changes from ESPHome (#1297) @bdraco
Sync api.proto from esphome for Bluetooth proxies (#1296) @bdraco
Prevent duplicate connection error logging when using reconnect_logic (#1294) @bdraco
Optimize Bluetooth UUID storage to use single short_uuid field (#1293) @bdraco
Add support for efficient Bluetooth UUID handling (#1291) @bdraco
Downgrade APIConnectionCancelledError log level to DEBUG in connection.py (#1289) @bdraco
<details> <summary>2 changes</summary>
media_player add off on capability (#1092) @rwrozelle
Media player API enumeration alignment and feature flags (#1285) @rwrozelle
Update protobuf api for zero-copy repeated field support (#1284) @bdraco
Add no zerocopy option for api proto (#1280) @bdraco
Sync api.proto from esphome (#1279) @bdraco
Skip waiting for ConnectResponse when no password is configured (#1276) @bdraco
<details> <summary>3 changes</summary>
Remove unused send_failed field from SubscribeLogsResponse (#1269) @bdraco
Downgrade APIConnectionCancelledError log level to DEBUG (#1267) @bdraco
Regenerate protobuf files with protoc 6.30.0 for runtime compatibility (#1265) @bdraco
Mark remaining deprecated protobuf items to reduce flash usage (#1262) @bdraco
Mark deprecated protobuf fields to reduce flash usage (#1261) @bdraco
<details> <summary>3 changes</summary>
One column per quarter.