---
id: habluetooth
version: "6.26.5"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# habluetooth — High availability Bluetooth

License: permissive · Maintenance: active · Downloads: 11.8M/mo

## What it is and what it does

habluetooth is a Python library that layers reliability and recovery logic on top of lower-level Bluetooth communication libraries. It depends on bleak (cross-platform Bluetooth Low Energy), dbus-fast (for Linux D-Bus integration), and several Bluetooth-specific helpers (bluetooth-adapters, bluetooth-auto-recovery, bluetooth-data-tools, btsocket, async-interrupt, bleak-retry-connector) to provide a unified interface for connecting to and communicating with Bluetooth devices while automatically handling disconnections, adapter failures, and other transient faults.

The package is in Pre-Alpha development but actively maintained, with wheels built for Python 3.11–3.14 across macOS (ARM64), Linux (x86_64, aarch64, armv7l, musl), and Windows (32/64-bit). It is designed for developers building applications that require robust Bluetooth device discovery and communication without manual retry logic or error recovery.

Use it for:

- Building IoT applications that connect to multiple Bluetooth devices and need automatic reconnection on adapter or device failure.
- Creating home automation integrations that maintain persistent Bluetooth links to sensors or actuators across network disruptions.
- Developing cross-platform Bluetooth client libraries that abstract away OS-specific D-Bus, CoreBluetooth, and Windows Bluetooth APIs.
- Implementing device discovery and pairing workflows that tolerate transient Bluetooth adapter unavailability.
- Prototyping Bluetooth-based services where connection resilience is more important than manual error handling.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides high-availability Bluetooth connectivity by wrapping lower-level Bluetooth libraries with resilience and recovery mechanisms for reliable device communication.

Yes, with conditions. The package is actively maintained, permissively licensed, and solves a real problem (Bluetooth reliability) with a focused dependency stack. However, it is Pre-Alpha, so API stability is not guaranteed and production use should be evaluated carefully. Install if you need high-availability Bluetooth and can tolerate potential breaking changes; avoid if you require a stable, mature API.

## Install

pip install habluetooth
uv add habluetooth
poetry add habluetooth

## Installing habluetooth

Before you install: Medium install friction due to 8 runtime dependencies including bleak, dbus-fast, and bluetooth-specific libraries. Active maintenance with recent releases; marked Pre-Alpha but supports current Python versions (3.11–3.14) across multiple platforms via pre-built wheels.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; attribution required but no copyleft obligations.

Quickstart:

pip install habluetooth

import habluetooth
# Instantiate and use high-availability Bluetooth connectivity
# via the package's main API (exact usage depends on exported classes/functions)

Requires Python >=3.11; on Linux may require dbus and system Bluetooth libraries; on Windows/macOS requires native Bluetooth stack access.

Verify before relying:

- Specific API surface and primary entry points (classes, async functions) not detailed in excerpt.
- Whether the package is intended for end-user applications or as a building block for other libraries.
- Scope of 'high availability' guarantees—e.g., failover strategy, reconnection behavior, timeout tuning.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: medium
- Maintenance: active
- Downloads: 11.8M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth connectivity library, high availability bluetooth, bluetooth device communication, bluetooth connection recovery, reliable bluetooth adapter, bluetooth auto-recovery, bluetooth retry mechanism, bluetooth, resilience, iot

[View on SkillFed](https://skillfed.io/packages/habluetooth) · [View on PyPI](https://pypi.org/project/habluetooth/)