simplepyble

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

SimplePyBLE provides cross-platform Bluetooth Low Energy (BLE) bindings for Windows, macOS, and Linux, with both synchronous and asynchronous APIs for discovering and communicating with BLE devices.

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

pip install simplepyble

uv add simplepyble

poetry add simplepyble

Installing simplepyble

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.

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())

On Debian/Ubuntu, install libdbus-1-dev headers before building from source. Requires Python 3.10 or later.

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

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

More Networking packages