NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #4686 most downloaded on PyPI
Python API for interacting with ESPHome devices.
Latest stable
46.30.0
Last release 10 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.
Add platform to wizard entities ( #2012 ) Jesse Hills (@jesserockz)
Pin the release wheel builders to ubuntu-24.04 ( #2010 ) J. Nick Koston (@bdraco)
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add the crash report request ( #1968 ) Keith Burzinski (@kbx81)
Add voice assistant wake word audio ( #1980 ) Michael Hansen (@synesthesiam) , J. Nick Koston (@bdraco) , Claude (@claude)
<details> <summary>2 changes</summary>
Sync the InfraredRFReceiveEvent timings span option from esphome ( #1999 ) J. Nick Koston (@bdraco)
interface_description string to UsbDeviceDescriptor (#1977) puddlyLog first reconnect failure at INFO instead of WARNING ( #1989 ) Allen Porter (@allenporter)
Send the probe ping also while a pong is pending ( #1986 ) David Buezas (@dbuezas) , J. Nick Koston (@bdraco)
<details> <summary>3 changes</summary>
Share one zeroconf listener and probe on announce bursts by default ( #1985 ) J. Nick Koston (@bdraco)
Add zeroconf_wake opt-out and notify_device_seen to ReconnectLogic ( #1970 ) Abe Haverkamp (@Doekse) , J. Nick Koston (@bdraco)
Sync the store_yaml api.proto changes from esphome ( #1958 ) J. Nick Koston (@bdraco)
Add optional and default_value to user service args ( #1891 ) Brandon Harvey (@bharvey88) , J. Nick Koston (@bdraco)
Add bitrate to MediaPlayerSupportedFormat ( #1917 ) Bryce Boe (@bboe) , J. Nick Koston (@bdraco)
Add support for cover toggle_action ( #1025 ) Felipe Santos (@felipecrs) , J. Nick Koston (@bdraco) , @Copilot
toggle_action (#1025) Felipe Santos (@felipecrs), J. Nick Koston (@bdraco), @CopilotAdd stop tilt support to covers ( #1925 ) Paul Bottein (@piitaya) , J. Nick Koston (@bdraco)
Add DeviceRelation to sub-device info ( #1955 ) Jesse Hills (@jesserockz)
Sync entity icon and device class progmem options with esphome ( #1950 ) J. Nick Koston (@bdraco)
Add Python 3.15 to the CI matrix ( #1957 ) J. Nick Koston (@bdraco)
Sync device info progmem options with esphome ( #1949 ) J. Nick Koston (@bdraco)
Nothing published for this version
Hide password text values in state logs ( #1942 ) Panoplian (@albert-canfield)
Add interface class and port number to UsbDeviceDescriptor ( #1941 ) puddly
Add multiple-entity wizard inputs ( #1935 ) @jesserockz , @bdraco
Add the Sendspin pairing token request ( #1931 ) @kahrendt
Sync DeviceWizardResponse options with esphome ( #1927 ) @bdraco
Add device wizard support ( #1918 ) Jesse Hills (@jesserockz) , J. Nick Koston (@bdraco)
Add missing_state to switch, climate and water heater states ( #1910 ) @tronikos , @bdraco
USB serial proxying and metadata subscription APIs ( #1901 ) @puddly
Pace IR/RF transmits on the device's completion response ( #1898 ) @bdraco
Add support for device-initiated outgoing connections ( #1893 ) @bdraco
Add description and example metadata to user service args ( #1890 ) @bharvey88
Mark media player supports_pause as deprecated in api.proto ( #1888 ) @bdraco
Add EntityState.with_device_id ( #1887 ) @bdraco
Add acknowledgements for proxy subscribe and configuration requests ( #1865 ) @kbx81
ConnectionClosedEvent for API consumers ( #1853 ) @puddly , @bdraco
Force re-release due to PyPI error ( #1879 ) @bdraco
Nothing published for this version
Add public bluetooth_device_disconnect_no_wait ( #1876 ) @bdraco
Add public noise module with sync handshake primitives ( #1874 ) @bdraco
<details> <summary>4 changes</summary>
Defer zeroconf loading until the mDNS wake listener is needed (#1870) @bdraco
Avoid loading uuid and timezone modules at import time (#1868) @bdraco
Add support for feeding newly discovered addresses into a running client (#1866) @bdraco
Sync api.proto bluetooth connection guards with esphome (#1863) @bdraco
Add workflow to open esphome bump PR on release (#1862) @bdraco
Avoid blocking connection setup on timezone resolution (#1857) @bdraco
<details> <summary>17 changes</summary>
Filter unspecified addresses from getaddrinfo results (#1834) @bdraco
<details> <summary>7 changes</summary>
Add deep_sleep param to async_run (#1828) @bdraco
Clarify deep_sleep is a bootstrap hint superseded by device_info (#1827) @bdraco
Support provisioning the encryption key over a zero-PSK noise connection (#1822) @bdraco
<details> <summary>11 changes</summary>
Revert tzlocal floor bump to stay compatible with pyicloud (#1803) @bdraco
Remove obsolete cibuildwheel free-threading enable group (#1802) @bdraco
Replace flag based cleanup in bluetooth_device_connect with per branch cleanup (#1764) @bdraco
Isolate user-callback exceptions in process_packet (#1762) @esphbot
<details> <summary>8 changes</summary>
Surface allocated connection slots in BluetoothConnectionsFree (#1741) @bluetoothbot
Add flag to suppress time updates by client by @clydebarrow in https://github.com/esphome/aioesphomeapi/pull/1733
Full Changelog: https://github.com/esphome/aioesphomeapi/compare/v45.2.0...v45.2.1
Surface configured_mode in BluetoothScannerStateResponse (#1740) @bluetoothbot
Add exhaustiveness guards for entity dispatch tables (#1735) @bluetoothbot
<details> <summary>5 changes</summary>
Sanitize peer-supplied mDNS labels in discover CLI (#1689) @bdraco
<details> <summary>3 changes</summary>
Sanitize peer DeviceInfo.name before storing as log_name (#1661) @bluetoothbot
This release adds two more defensive fixes around the unauthenticated portion of the Noise handshake. Both are low-severity hardening rather than expl
This release adds two more defensive fixes around the unauthenticated portion of the Noise handshake. Both are low-severity hardening rather than exploitable RCE-style bugs, but worth upgrading for if you log to anything you'd rather not poison or leak.
server_name, mac_address, and handshake-failure explanation before logging. These three fields ride on the wire before the PSK-authenticated handshake completes, so an on-path attacker (ARP spoof, compromised VLAN device, MITM during plaintext-mode hello) can put anything in them. The previous code interpolated them unescaped into log/error messages and stashed them on self for reuse by every later error path — letting an attacker inject CRLF + ANSI escape sequences into operator-visible logs (HA UI, syslog, monitoring webhooks), forge fake log lines, hijack terminals via CSI sequences, or impersonate a different device's identity in alert messages. The fix decodes once with errors="replace", strips non-printable characters, length-caps to the firmware's actual wire-format limits (32/16/64 bytes), and compares the raw decoded value (not the sanitized one) against expected_name / expected_mac so sanitization can't be used to bypass the identity check. Fixed in #1656.Malformed PSK error messages. _decode_noise_psk() previously embedded the raw PSK string in InvalidEncryptionKeyAPIError on both failure paths (invalid base64, wrong byte length). The exception is logged at WARNING level by the connection layer, so the raw PSK landed in every sink (file logs, journald, log aggregators, Sentry, HA diagnostics bundles). Even a malformed PSK is highly sensitive — typos are nearly identical to the real key, clipboard pastes can carry stray characters, and the pasted value may simply be the real PSK of a sibling device. The fix replaces the value with its character length, which is enough to diagnose paste/encoding errors without exposing the secret. Fixed in #1657.Threat model is "configuration-time / pre-handshake exposure," not a remote unauthenticated attack — same shape as v45.0.1's fixes.
This release adds bounds checks for several DoS vectors that a misbehaving or compromised ESPHome device could use to OOM the client process (typicall
This release adds bounds checks for several DoS vectors that a misbehaving or compromised ESPHome device could use to OOM the client process (typically Home Assistant). All three require an established API session — i.e. a device the user has already adopted — but a malicious or buggy peer in that session was previously able to:
CameraImageResponse chunks indefinitely or rotate cam_msg.key across ~4 billion values to grow the per-subscription reassembly buffer without bound. Affects every install that has an ESPHome camera. Fixed in #1648.length varuint of arbitrary size in plaintext mode (no noise_psk), causing the client to buffer up to that many bytes — easy multi-GiB allocation — or stream \x80\x80… indefinitely with no terminator, growing the receive buffer and forcing repeated O(N²) bigint shifts on every data_received. The noise path was incidentally protected by its fixed 16-bit length header; plaintext had no equivalent cap. Fixed in #1651.msg_type=0, which silently routed the payload to the last registered protobuf class instead of dropping it as an unknown message type. Low impact in practice (the connection drops anyway when the parse fails) but a footgun for future code. Fixed in #1645.Threat model is "adopted device misbehaves," not a remote unauthenticated attack. Plaintext-mode users should upgrade preferentially since #1651 lowers the bar to "anyone who can reach the device on the LAN" (no noise_psk means no auth on the wire and a network attacker can MITM).
<details> <summary>3 changes</summary>
One column per quarter.