Welcome to bleak-esphome documentation!

Installation & Usage

• Installation
• Usage
  • Handling start cancellation
  • Advanced: wiring connect_scanner directly
  • Extension Methods
  • Feature Flag Reference
• Architecture
  • What this library is — and what it is not
  • Where the proxy is implemented
  • How features are negotiated
  • On-demand active scanning
  • Who can use it
  • See also
• API reference
  • High-level entry point
  • Low-level escape hatch

Project Info

• Changelog
  • v3.9.1 (2026-05-23)
  • v3.9.0 (2026-05-23)
  • v3.8.4 (2026-05-23)
  • v3.8.3 (2026-05-23)
  • v3.8.2 (2026-05-23)
  • v3.8.1 (2026-05-23)
  • v3.8.0 (2026-05-23)
  • v3.7.6 (2026-05-21)
  • v3.7.5 (2026-05-16)
  • v3.7.4 (2026-05-14)
  • v3.7.3 (2026-04-11)
  • v3.7.2 (2026-04-11)
  • v3.7.1 (2026-03-07)
  • v3.7.0 (2026-03-07)
  • v3.6.1 (2026-03-07)
  • v3.6.0 (2026-01-27)
  • v3.5.0 (2026-01-27)
  • v3.4.1 (2026-01-25)
  • v3.4.0 (2025-10-04)
  • v3.3.0 (2025-09-08)
  • v3.2.0 (2025-08-28)
  • v3.1.0 (2025-07-03)
  • v3.0.1 (2025-07-03)
  • v3.0.0 (2025-07-03)
  • v2.16.0 (2025-06-03)
  • v2.15.1 (2025-05-03)
  • v2.15.0 (2025-04-29)
  • v2.14.0 (2025-04-27)
  • v2.13.1 (2025-04-03)
  • v2.13.0 (2025-04-03)
  • v2.12.0 (2025-03-13)
  • v2.11.0 (2025-03-05)
  • v2.10.2 (2025-03-04)
  • v2.10.1 (2025-03-04)
  • v2.10.0 (2025-03-04)
  • v2.9.0 (2025-02-27)
  • v2.8.0 (2025-02-27)
  • v2.7.1 (2025-02-04)
  • v2.7.0 (2025-02-02)
  • v2.6.0 (2025-01-31)
  • v2.5.0 (2025-01-31)
  • v2.4.0 (2025-01-31)
  • v2.3.0 (2025-01-31)
  • v2.2.0 (2025-01-28)
  • v2.1.1 (2025-01-22)
  • v2.1.0 (2025-01-22)
  • v2.0.0 (2025-01-03)
  • v1.1.1 (2024-12-22)
  • v1.1.0 (2024-10-05)
  • v1.0.0 (2024-02-18)
  • v0.4.1 (2024-01-01)
  • v0.4.0 (2023-12-17)
  • v0.3.0 (2023-12-14)
  • v0.2.0 (2023-12-13)
  • v0.1.0 (2023-12-13)
  • v0.0.0 (2023-12-06)
• Contributing
  • Types of Contributions
  • Get Started!
  • Pull Request Guidelines
  • Tips
  • Making a new release

bleak-esphome

---

Documentation: https://bleak-esphome.readthedocs.io

Source Code: https://github.com/bluetooth-devices/bleak-esphome

---

A Bleak backend that proxies Bluetooth Low Energy through an ESP32 running ESPHome with the Bluetooth Proxy component. It lets any Python application — Home Assistant, an add-on, or a stand-alone script — discover and connect to BLE peripherals using a remote ESP32 as the adapter. The Bluetooth Proxy firmware itself lives in the ESPHome project; this library is the host-side client. See the architecture docs for how the pieces fit together.

Installation

Install this via pip (or your favourite package manager):

pip install bleak-esphome

Contributors ✨

Thanks goes to these wonderful people (emoji key):

This project follows the all-contributors specification. Contributions of any kind welcome!

Credits

This package was created with Copier and the browniebroke/pypackage-template project template.