bumble

library0.0.229pypypi✓ verified 82d ago

Bumble is a Bluetooth stack written in Python for apps, emulation, testing, and experimentation. It supports Bluetooth Classic, BLE, and HCI. Current version: 0.0.229. Release cadence is irregular.

devops testing

pip install bumble

github ↗homepage ↗

INSTALL

IMPORT

SIG · BUMBLE

bumble

devopspythonv0.0.229

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Device

✓ from bumble.device import Device

✗ from bumble.core import Device

A simple BLE scanner that prints advertisements for 5 seconds.

import asyncio from bumble.adapter import Adapter from bumble.core import Device async def scan(): adapter = Adapter() await adapter.start() scanner = adapter.create_scanner() scanner.on('advertisement', lambda device: print(f'Device: {device}')) await scanner.start() await asyncio.sleep(5) await scanner.stop() await adapter.stop() asyncio.run(scan())

Debug

Known issues

breakingBumble is pre-1.0 and undergoes major API changes frequently. Code written for 0.0.200 may not work with 0.0.229.

fix

Pin exact version in requirements.txt or check the changelog before upgrading.

affects: <1.0.0

deprecatedThe 'Bumble' class in bumble.device was removed in v0.0.220. Use Device from bumble.core instead.

fix

Change imports to 'from bumble.core import Device'.

affects: >=0.0.220

gotchaMost APIs are async. Forgetting 'await' can lead to coroutine objects being printed or ignored silently.

fix

Always use asyncio.run() or await inside async functions; never call async methods without await.

affects: all

Upgrade

Version history

0.0.229latest on PyPI · released May 26, 2026

Audit

Dependencies

cryptographyrequiredrequired for BLE security operations

pyusboptionalrequired for USB HCI transport

pyserialoptionalrequired for serial HCI transport

Agent activity

33 hits · last 30 days

node

Amazon

OpenAI (training)

Resources

githubhttps://github.com/google/bumble ↗

homepagehttps://github.com/google/bumble ↗