bumble
Bluetooth Stack for Apps, Emulation, Test and Experimentation
Decision gist · record as of 2026-08-14
Yes, if you need a Python-native Bluetooth stack for prototyping, testing, or experimentation with BLE or Classic devices. The active maintenance, permissive license, and low install friction make it accessible. However, the alpha status and explicit production disclaimer mean it is not suitable for production deployments—use for research, development, and testing only.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Physical radio use requires a USB Bluetooth dongle or UART/VHCI transport; internal OS Bluetooth interfaces are typically locked down.
- Low friction install as a pure Python wheel.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache 2.0 (permissive), allowing use in commercial and private projects with minimal restrictions beyond attribution and liability disclaimers.
last release 2026-07-15 (30 days) · last repo commit 2026-07-23 · 542 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 109,439 downloads/mo, #12,515 on PyPI
Alternatives
Verify before relying
pip install bumble
import bumble.device
import bumble.hci
# Create and configure a Bluetooth device
device = bumble.device.Device(name='MyDevice')- Whether all 15 runtime dependencies are required for basic usage or if subsets suffice for specific use cases
- Current stability and production-readiness status beyond the alpha disclaimer in the description
What it is and what it does
Bumble is a Bluetooth stack implementation written entirely in Python that provides both protocol-level support and higher-level abstractions for Bluetooth Low Energy (BLE) and Bluetooth Classic (BR/EDR) communication. It implements core protocols including GAP, L2CAP, ATT, GATT, SMP, SDP, RFCOMM, HFP, HID, and A2DP, and can interface with physical Bluetooth radios via USB, UART, or Linux VHCI, as well as virtual radios including the Android emulator's virtual Bluetooth support.
The package is designed for applications, emulation, testing, and experimentation rather than production deployment. It depends on cryptography for security operations, websockets and aiohttp for network communication, pyserial and pyusb for hardware transport, and several UI/CLI tools like click, prompt_toolkit, and prettytable. The library is maintained by Google but explicitly disclaimed as not an official product and remains in alpha with breaking changes expected.
Use it for
- Build Bluetooth-enabled applications and prototypes that communicate with BLE or Classic devices without relying on OS-level Bluetooth APIs
- Test and validate Bluetooth device behavior by emulating devices and profiles in a controlled Python environment
- Experiment with Bluetooth protocols and develop custom protocol implementations using the stack's modular architecture
- Debug Bluetooth communication by capturing and analyzing HCI traffic over USB dongles or UART connections
- Simulate Bluetooth interactions in the Android emulator or other virtual environments for development and CI/CD testing
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you need a Python-native Bluetooth stack for prototyping, testing, or experimentation with BLE or Classic devices.
The active maintenance, permissive license, and low install friction make it accessible. However, the alpha status and explicit production disclaimer mean it is not suitable for production deployments—use for research, development, and testing only.
Install
bumble on PyPI
Before you install
Low friction install as a pure Python wheel. Active maintenance with a release 30 days ago and commits through late July 2026. Requires Python 3.10 or later and pulls in 15 runtime dependencies including cryptography, websockets, and USB libraries.
Requires Python 3.10 or later. Physical radio use requires a USB Bluetooth dongle or UART/VHCI transport; internal OS Bluetooth interfaces are typically locked down.
License in practice
Licensed under Apache 2.0 (permissive), allowing use in commercial and private projects with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install bumble
import bumble.device
import bumble.hci
# Create and configure a Bluetooth device
device = bumble.device.Device(name='MyDevice')Verify before relying
- Whether all 15 runtime dependencies are required for basic usage or if subsets suffice for specific use cases
- Current stability and production-readiness status beyond the alpha disclaimer in the description
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 15 packagesaiohttpclickcryptographyhumanizeplatformdirsprompt_toolkitprettytablepyeetomliwebsocketspyserial-asynciopyseriallibusb1libusb-packagepyusb |
| Maintenance | Actively maintained 30 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 109,439 / month, #12,515 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: bumble-0.0.233-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 stack python”
- bumbleBumble is a full-featured Bluetooth stack written in Python that…
- btsocketA Python library for controlling BlueZ Bluetooth adapters on Linux…
- Adax-localA Python library for local communication with Adax heating devices…
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 xiaomi-ble · govee-ble · bleak-esphome · bleak · winrt-Windows.Devices.Bluetooth.GenericAttributeProfile · aioblescan · matter-ble-proxy · kegtron-ble · smpmgr · pybatfish