---
id: home-assistant-bluetooth
version: "2.0.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# home-assistant-bluetooth — Home Assistant Bluetooth Models and Helpers

License: permissive · Maintenance: active · Downloads: 766.2K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 766.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

bluetooth advertisement data models, home assistant ble integration, bluetooth service info parsing, ble device data structures, home assistant bluetooth helpers, home-assistant, bluetooth-ble, data-models

[View on SkillFed](https://skillfed.io/packages/home-assistant-bluetooth) · [View on PyPI](https://pypi.org/project/home-assistant-bluetooth/)