bleak-esphome
Bleak backend of ESPHome
Decision gist · record as of 2026-08-14
Yes, if you have an ESP32 running ESPHome Bluetooth Proxy and need remote BLE connectivity from Python. The package is actively maintained, has no known vulnerabilities, and uses a permissive MIT license. Pre-alpha status means the API may change, so pin the version in production. Medium install friction is acceptable for the capability it provides.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; also requires a running ESP32 device with ESPHome Bluetooth Proxy firmware installed and network connectivity to that device.
- Medium install friction due to compiled wheels across multiple platforms and Python versions (3.11–3.14).
- Active maintenance with a recent release 39 days ago and ongoing commits.
License · maintenance · safety
MIT (permissive) — MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and proprietary projects.
last release 2026-07-06 (39 days) · last repo commit 2026-08-10 · 9 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 217,759 downloads/mo, #9,352 on PyPI
Alternatives
Verify before relying
pip install bleak-esphome
import bleak_esphome
# Use as a Bleak backend to discover BLE devices through ESPHome Bluetooth Proxy
# Requires an ESP32 running ESPHome with Bluetooth Proxy component configured- Whether the package works with all ESPHome versions or has specific firmware version requirements.
- Performance characteristics when proxying multiple simultaneous BLE connections.
- Network latency impact on BLE operations compared to local adapters.
What it is and what it does
bleak-esphome is a Bleak backend library that extends Bluetooth Low Energy support to remote devices by proxying BLE connections through an ESP32 microcontroller running ESPHome's Bluetooth Proxy component. Instead of requiring a local Bluetooth adapter, your Python application communicates with a remote ESP32 over the network, which handles the actual BLE radio operations. This is useful when your host machine lacks Bluetooth hardware or when you want to centralize BLE connectivity across a network.
The library sits between your application and the ESPHome device, translating Bleak's standard BLE API calls into network requests to the Bluetooth Proxy firmware. It depends on aioesphomeapi for device communication, bleak for the core BLE interface, and several supporting libraries for data handling and connection resilience. The package is in pre-alpha status but actively maintained, with support for Python 3.11 through 3.14 across Windows, macOS, and Linux platforms.
Use it for
- Home Assistant add-ons or integrations that need to discover and control BLE devices without local Bluetooth hardware.
- Headless servers or cloud instances that centralize BLE device management through a remote ESP32 proxy.
- Multi-device BLE applications where a single ESP32 acts as a shared Bluetooth gateway for several host machines.
- Testing BLE applications on systems without native Bluetooth support by routing through a networked ESP32.
- IoT setups where BLE peripherals are physically distant from the main application host.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you have an ESP32 running ESPHome Bluetooth Proxy and need remote BLE connectivity from Python.
The package is actively maintained, has no known vulnerabilities, and uses a permissive MIT license. Pre-alpha status means the API may change, so pin the version in production. Medium install friction is acceptable for the capability it provides.
Install
bleak-esphome on PyPI
Before you install
Medium install friction due to compiled wheels across multiple platforms and Python versions (3.11–3.14). Active maintenance with a recent release 39 days ago and ongoing commits. Six runtime dependencies including bleak and aioesphomeapi add some complexity.
Requires Python 3.11 or later; also requires a running ESP32 device with ESPHome Bluetooth Proxy firmware installed and network connectivity to that device.
License in practice
MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and proprietary projects.
Quickstart
pip install bleak-esphome
import bleak_esphome
# Use as a Bleak backend to discover BLE devices through ESPHome Bluetooth Proxy
# Requires an ESP32 running ESPHome with Bluetooth Proxy component configuredVerify before relying
- Whether the package works with all ESPHome versions or has specific firmware version requirements.
- Performance characteristics when proxying multiple simultaneous BLE connections.
- Network latency impact on BLE operations compared to local adapters.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 6 packagesaioesphomeapibleakbleak-retry-connectorbluetooth-data-toolshabluetoothlru-dict |
| Maintenance | Actively maintained 39 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 217,759 / month, #9,352 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 2 - Pre-AlphaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseNatural Language :: EnglishOperating System :: OS IndependentProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Software Development :: Libraries |
Evidence: bleak_esphome-3.9.7-cp311-cp311-macosx_10_9_x86_64.whl; bleak_esphome-3.9.7-cp311-cp311-macosx_11_0_arm64.whl; bleak_esphome-3.9.7-cp311-cp311-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; bleak_esphome-3.9.7-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; bleak_esphome-3.9.7-cp311-cp311-musllinux_1_2_aarch64.whl; bleak_esphome-3.9.7-cp311-cp311-musllinux_1_2_x86_64.whl; bleak_esphome-3.9.7-cp311-cp311-win32.whl; bleak_esphome-3.9.7-cp311-cp311-win_amd64.whl; bleak_esphome-3.9.7-cp312-cp312-macosx_10_13_x86_64.whl; bleak_esphome-3.9.7-cp312-cp312-macosx_11_0_arm64.whl; bleak_esphome-3.9.7-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; bleak_esphome-3.9.7-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl; bleak_esphome-3.9.7-cp312-cp312-musllinux_1_2_aarch64.whl; bleak_esphome-3.9.7-cp312-cp312-musllinux_1_2_x86_64.whl; bleak_esphome-3.9.7-cp312-cp312-win32.whl; bleak_esphome-3.9.7-cp312-cp312-win_amd64.whl; bleak_esphome-3.9.7-cp313-cp313-macosx_10_13_x86_64.whl; bleak_esphome-3.9.7-cp313-cp313-macosx_11_0_arm64.whl; bleak_esphome-3.9.7-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl; bleak_esphome-3.9.7-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “bluetooth low energy proxy esp32”
- bleak-esphomeProvides a Bleak backend that proxies Bluetooth Low Energy…
- bleak-retry-connectorWraps Bleak's Bluetooth client with automatic retry logic and backoff…
- simplepybleSimplePyBLE provides cross-platform Bluetooth Low Energy (BLE)…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also bleak · bleak-retry-connector · govee-ble · simplepyble · bumble · kegtron-ble · matter-ble-proxy · ibeacon-ble · habluetooth · xiaomi-ble