simplepyble
The ultimate fully-fledged cross-platform BLE library, designed for simplicity and ease of use.
Decision gist · record as of 2026-08-14
Yes, with licensing conditions. Install if you need cross-platform BLE support and your use case is non-commercial or you can obtain a commercial license. The library is actively maintained, has no known vulnerabilities, and provides a clean API across platforms. However, verify upfront whether your intended use qualifies as non-commercial under BUSL-1.1 terms, or budget for a commercial license if building proprietary applications.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- On Debian/Ubuntu, install libdbus-1-dev headers before building from source.
- Requires Python 3.10 or later.
- Medium install friction due to platform-specific compiled wheels; on Debian/Ubuntu, requires libdbus-1-dev headers.
License · maintenance · safety
non-commercial license (noncommercial) — Licensed under Business Source License 1.1 (BUSL-1.1) with a non-commercial perpetual use grant; free for non-commercial use but requires a commercial license for proprietary applications. Converts to GPL-3 four years after each release.
last release 2026-08-10 (4 days) · last repo commit 2026-08-13 · 1,113 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 160,547 downloads/mo, #10,656 on PyPI
Alternatives
Verify before relying
pip install simplepyble
import asyncio
from simplepyble.aio import Adapter
async def main():
adapters = Adapter.get_adapters()
adapter = adapters[0]
async with adapter:
await adapter.scan_for(5000)
peripherals = adapter.scan_get_results()
for peripheral in peripherals:
print(f"Found: {peripheral.identifier()} [{peripheral.address()}]")
asyncio.run(main())- Whether the asynchronous API (simplepyble.aio) is production-ready or still experimental
- Performance characteristics and latency guarantees for BLE operations across platforms
- Specific BLE services and characteristics supported or any known limitations
What it is and what it does
SimplePyBLE is a cross-platform Bluetooth Low Energy library that abstracts away the complexity of platform-specific BLE APIs on Windows, macOS, and Linux. It provides a unified Python interface for discovering BLE devices, scanning for peripherals, and managing connections through both synchronous and asynchronous patterns. The package wraps lower-level BLE implementations (DBus on Linux, native APIs on Windows and macOS) and exposes them through a clean, consistent API.
The library is designed for developers who need to build BLE applications without wrestling with platform differences. It supports modern Python versions (3.10+) and includes an asyncio-compatible module for non-blocking operations. Installation is straightforward via pip, though platform-specific system libraries (like libdbus-1-dev on Linux) may be required. The package carries no Python runtime dependencies, keeping your dependency tree lightweight.
Use it for
- Build cross-platform applications that discover and connect to Bluetooth wearables, sensors, or IoT devices
- Scan for BLE peripherals and retrieve their identifiers and addresses for device inventory or pairing workflows
- Integrate asynchronous BLE communication into event-driven Python applications using asyncio
- Prototype and test BLE device interactions on multiple operating systems without rewriting platform-specific code
- Develop commercial BLE applications (with appropriate licensing) for Windows, macOS, and Linux simultaneously
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with licensing conditions.
Install if you need cross-platform BLE support and your use case is non-commercial or you can obtain a commercial license. The library is actively maintained, has no known vulnerabilities, and provides a clean API across platforms. However, verify upfront whether your intended use qualifies as non-commercial under BUSL-1.1 terms, or budget for a commercial license if building proprietary applications.
Install
simplepyble on PyPI
Before you install
Medium install friction due to platform-specific compiled wheels; on Debian/Ubuntu, requires libdbus-1-dev headers. Actively maintained with recent release (4 days old) and steady repository activity.
On Debian/Ubuntu, install libdbus-1-dev headers before building from source. Requires Python 3.10 or later.
License in practice
Licensed under Business Source License 1.1 (BUSL-1.1) with a non-commercial perpetual use grant; free for non-commercial use but requires a commercial license for proprietary applications. Converts to GPL-3 four years after each release.
Quickstart
pip install simplepyble
import asyncio
from simplepyble.aio import Adapter
async def main():
adapters = Adapter.get_adapters()
adapter = adapters[0]
async with adapter:
await adapter.scan_for(5000)
peripherals = adapter.scan_get_results()
for peripheral in peripherals:
print(f"Found: {peripheral.identifier()} [{peripheral.address()}]")
asyncio.run(main())Verify before relying
- Whether the asynchronous API (simplepyble.aio) is production-ready or still experimental
- Performance characteristics and latency guarantees for BLE operations across platforms
- Specific BLE services and characteristics supported or any known limitations
Package facts
| License | non-commercial license noncommercial |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | None |
| Maintenance | Actively maintained 4 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 160,547 / month, #10,656 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: Free for non-commercial useLicense :: Other/Proprietary LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14 |
Evidence: simplepyble-1.1.0-cp310-cp310-macosx_13_0_arm64.whl; simplepyble-1.1.0-cp310-cp310-macosx_13_0_universal2.whl; simplepyble-1.1.0-cp310-cp310-macosx_13_0_x86_64.whl; simplepyble-1.1.0-cp310-cp310-manylinux_2_28_aarch64.whl; simplepyble-1.1.0-cp310-cp310-manylinux_2_28_i686.whl; simplepyble-1.1.0-cp310-cp310-manylinux_2_28_x86_64.whl; simplepyble-1.1.0-cp310-cp310-win32.whl; simplepyble-1.1.0-cp310-cp310-win_amd64.whl; simplepyble-1.1.0-cp310-cp310-win_arm64.whl; simplepyble-1.1.0-cp311-cp311-macosx_13_0_arm64.whl; simplepyble-1.1.0-cp311-cp311-macosx_13_0_universal2.whl; simplepyble-1.1.0-cp311-cp311-macosx_13_0_x86_64.whl; simplepyble-1.1.0-cp311-cp311-manylinux_2_28_aarch64.whl; simplepyble-1.1.0-cp311-cp311-manylinux_2_28_i686.whl; simplepyble-1.1.0-cp311-cp311-manylinux_2_28_x86_64.whl; simplepyble-1.1.0-cp311-cp311-win32.whl; simplepyble-1.1.0-cp311-cp311-win_amd64.whl; simplepyble-1.1.0-cp311-cp311-win_arm64.whl; simplepyble-1.1.0-cp312-cp312-macosx_13_0_arm64.whl; simplepyble-1.1.0-cp312-cp312-macosx_13_0_universal2.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 python”
- simplepybleSimplePyBLE provides cross-platform Bluetooth Low Energy (BLE)…
- bleak-esphomeProvides a Bleak backend that proxies Bluetooth Low Energy…
- bleakBleak is an async Python client for connecting to and communicating…
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 · xiaomi-ble · aiobmsble · govee-ble · matter-ble-proxy · bleak · led-ble · bumble · pyobjc-framework-CoreBluetooth · kegtron-ble