---
id: bleak-esphome
version: "3.9.7"
license: MIT
license_treatment: permissive
maintenance: active
---

# bleak-esphome — Bleak backend of ESPHome

License: permissive · Maintenance: active · Downloads: 217.8K/mo

## 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 above — verify before relying.

Provides a Bleak backend that proxies Bluetooth Low Energy connections through an ESP32 running ESPHome's Bluetooth Proxy component, allowing Python applications to discover and connect to BLE peripherals via a remote adapter.

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

pip install bleak-esphome
uv add bleak-esphome
poetry add bleak-esphome

## Installing bleak-esphome

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.

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 configured

Requires Python 3.11 or later; also requires a running ESP32 device with ESPHome Bluetooth Proxy firmware installed and network connectivity to that device.

Verify 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_current
- Install friction: medium
- Maintenance: active
- Downloads: 217.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth low energy proxy esp32, bleak backend esphome, remote ble adapter, bluetooth proxy client, ble peripheral discovery remote, esphome bluetooth connectivity, ble over network, bluetooth-proxy, esphome-integration, iot

[View on SkillFed](https://skillfed.io/packages/bleak-esphome) · [View on PyPI](https://pypi.org/project/bleak-esphome/)