bleak
Bluetooth Low Energy platform Agnostic Klient
Decision gist · record as of 2026-08-14
Yes. Bleak is actively maintained, widely used (top 5000 PyPI), has no known vulnerabilities, and offers a clean async API for BLE communication across major platforms. Install it if you need to communicate with BLE devices from Python. The main gotcha is platform-specific system dependencies and the Python 3.10 or later requirement—verify those match your environment before committing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Platform-specific system libraries required.
- Do not name your script 'bleak.py' as it causes circular import errors.
License · maintenance · safety
MIT (permissive) — MIT license (permissive) means you can use, modify, and distribute Bleak freely in both open-source and proprietary projects with minimal restrictions—only attribution is required.
last release 2026-05-02 (104 days) · last repo commit 2026-08-05 · 2,491 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 2,131,283 downloads/mo, #3,268 on PyPI
Alternatives
Verify before relying
import asyncio
from bleak import BleakScanner, BleakClient
async def discover():
devices = await BleakScanner.discover()
return devices
async def read_characteristic(address, uuid):
async with BleakClient(address) as client:
value = await client.read_gatt_char(uuid)
return value
asyncio.run(discover())- Whether all 15 runtime dependencies are required on all platforms or only conditionally installed per OS
- Specific version constraints for system libraries beyond Windows 11 version 22000 and BlueZ 5.55
What it is and what it does
Bleak is a cross-platform async Python library for building Bluetooth Low Energy (BLE) clients that connect to and communicate with BLE devices. It abstracts away platform differences using native APIs on Windows, macOS, Linux, and Android, so you write one async/await-based client that works everywhere. The library handles device discovery, GATT characteristic reading and writing, and subscription to notifications from BLE sensors and peripherals.
Typical use involves discovering nearby BLE devices, connecting to a specific device by address, and then reading or writing GATT characteristics identified by UUID. All operations are async, making it suitable for applications that need to manage multiple concurrent BLE connections or integrate BLE communication into larger async event loops. The library depends on platform-specific system libraries and Python 3.10 or later.
Use it for
- Discover and connect to BLE fitness trackers, smartwatches, or health sensors to read real-time data
- Build IoT applications that communicate with BLE-enabled environmental sensors or industrial devices
- Create cross-platform desktop or mobile apps that interface with Bluetooth peripherals without platform-specific code
- Read notifications and characteristic values from BLE GATT servers in real-time monitoring systems
- Prototype and test BLE device firmware by scripting client-side interactions with test devices
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
Bleak is actively maintained, widely used (top 5000 PyPI), has no known vulnerabilities, and offers a clean async API for BLE communication across major platforms. Install it if you need to communicate with BLE devices from Python. The main gotcha is platform-specific system dependencies and the Python 3.10 or later requirement—verify those match your environment before committing.
Install
bleak on PyPI
Before you install
Low install friction with a pure-wheel distribution. Active maintenance with a recent commit on 2026-08-05 and 2491 repository stars. Requires Python 3.10 or later. Runtime dependencies are platform-specific, so actual install complexity varies by OS.
Requires Python 3.10 or later. Platform-specific system libraries required. Do not name your script 'bleak.py' as it causes circular import errors.
License in practice
MIT license (permissive) means you can use, modify, and distribute Bleak freely in both open-source and proprietary projects with minimal restrictions—only attribution is required.
Quickstart
import asyncio
from bleak import BleakScanner, BleakClient
async def discover():
devices = await BleakScanner.discover()
return devices
async def read_characteristic(address, uuid):
async with BleakClient(address) as client:
value = await client.read_gatt_char(uuid)
return value
asyncio.run(discover())Verify before relying
- Whether all 15 runtime dependencies are required on all platforms or only conditionally installed per OS
- Specific version constraints for system libraries beyond Windows 11 version 22000 and BlueZ 5.55
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagesasync-timeouttyping-extensionspyobjc-corepyobjc-framework-corebluetoothpyobjc-framework-libdispatchwinrt-runtimewinrt-windows-devices-bluetoothwinrt-windows-devices-bluetooth-advertisementwinrt-windows-devices-bluetooth-genericattributeprofilewinrt-windows-devices-enumerationwinrt-windows-devices-radioswinrt-windows-foundationwinrt-windows-foundation-collectionswinrt-windows-storage-streamsdbus-fast |
| Maintenance | Actively maintained 104 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 2,131,283 / month, #3,268 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Framework :: AsyncIOOperating System :: AndroidOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: Windows :: Windows 11Operating System :: POSIX :: Linux |
Evidence: bleak-3.0.2-py3-none-any.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 client”
- bleakBleak is an async Python client for connecting to and communicating…
- bleak-esphomeProvides a Bleak backend that proxies Bluetooth Low Energy…
- simplepybleSimplePyBLE provides cross-platform Bluetooth Low Energy (BLE)…
Give your agent the search over MCP, or paste the wish link into any chat.
More Networking packages
h11 is a pure-Python HTTP/1.1 protocol implementation that handles parsing and serializing HTTP messages without any built-in I/O, letting you integrate it with any network layer you choose.
psutil retrieves real-time information about running processes and system resources (CPU, memory, disks, network, sensors) across multiple operating systems, enabling system monitoring, process profiling, and resource management.
pyOpenSSL wraps OpenSSL's SSL/TLS functionality for Python, providing high-level connection objects and certificate handling through a Python-friendly interface around OpenSSL's cryptographic operations.
uvloop is a drop-in replacement for Python's built-in asyncio event loop, implemented in Cython and using libuv, that accelerates async I/O operations.
execnet lets you spawn and communicate with Python interpreters across local processes, remote hosts, and different platforms, using a simple API for task distribution and inter-process messaging.
However, the aging maintenance status (275 days since last release) means you should verify it meets your concurrency and performance needs before committing to a…
PyZMQ provides Python bindings for ZeroMQ (ØMQ), a lightweight messaging library that enables fast, asynchronous communication between distributed processes and applications.
See also bleak-esphome · bumble · home-assistant-bluetooth · xiaomi-ble · bleak-retry-connector · govee-ble · ibeacon-ble · kegtron-ble · airthings-ble · simplepyble