home-assistant-bluetooth

What it is and what it does

home-assistant-bluetooth is a data model library that standardizes Bluetooth advertisement information for Home Assistant. It defines the BluetoothServiceInfo dataclass, which wraps Bluetooth device data from bleak (a popular BLE library) and adds a source field to track which Bluetooth transceiver reported the data. This is useful for Home Assistant integrations and libraries that need to parse and work with BLE advertisement data in a consistent format.

The package is lightweight, with only one runtime dependency (habluetooth), and is designed as a shared contract between Home Assistant's Bluetooth infrastructure and individual integrations. It supports Python 3.11, 3.12, and 3.13, and is actively maintained. The library is particularly relevant for scenarios where Home Assistant may eventually support remote Bluetooth transceivers, allowing the source field to help determine which device is closest.

Use it for:

• Parsing standardized Bluetooth advertisement data in Home Assistant integrations that work with BLE devices.
• Building Bluetooth device discovery and pairing workflows that need consistent data structures across multiple integrations.
• Determining the source of Bluetooth signals when multiple transceivers are available in a Home Assistant setup.
• Creating libraries that integrate with Home Assistant's Bluetooth infrastructure without reimplementing data models.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides standardized data models and helpers for working with Bluetooth advertisement data in Home Assistant, wrapping bleak's BLE device information into a unified BluetoothServiceInfo structure.

Yes, if you are developing a Home Assistant integration or library that works with Bluetooth devices. The low install friction, active maintenance, permissive license, and production-stable status make it a safe dependency. If you are working outside the Home Assistant ecosystem, verify whether this package's data models and source-tracking design align with your use case.

Install

home-assistant-bluetooth on PyPI

pip install home-assistant-bluetooth

uv add home-assistant-bluetooth

poetry add home-assistant-bluetooth

Installing home-assistant-bluetooth

Before you install

Low install friction with a single runtime dependency (habluetooth). Active maintenance with a recent commit on 2026-08-10 and production-stable status.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install home-assistant-bluetooth

from home_assistant_bluetooth import BluetoothServiceInfo

# BluetoothServiceInfo dataclass provides standardized fields:
# name, address, rssi, manufacturer_data, service_data, service_uuids, source

Requires Python 3.11 or later.

Verify before relying

• Whether habluetooth is a Home Assistant-specific package or a general-purpose Bluetooth library.
• How the source field is populated and whether it requires Home Assistant infrastructure.
• Whether this package is intended for use outside Home Assistant integrations.

Package facts

Evidence: home_assistant_bluetooth-2.0.0-py3-none-any.whl

Tags

More Libraries packages