bluetooth-mesh-bluez

Bluetooth mesh SDK for Python allows developing applications communicating with Bluetooth mesh network using BlueZ's bluetooth-meshd.

What is this thing?

This library provides a high-level async API for interacting with BlueZ mesh stack via D-Bus interface.

Supported features include:

Application framework: high-level API for creating mesh applications, elements, and models
D-Bus integration: async communication with bluetooth-meshd via dbus-next
Model support: configuration, generic, light, sensor, scene, time, and Silvair-specific models
Provisioning: provisioner and provision agent interfaces

This project requires Python 3.14.

You can install "bluetooth-mesh-bluez" via pip from PyPI:

$ pip install bluetooth-mesh-bluez

You can also add it to a Poetry-managed project:

$ poetry add bluetooth-mesh-bluez

If you want to work on this repository locally, install the project and development dependencies with Poetry:

$ poetry install

Contributions are very welcome. Tests can be run with pytest, please ensure the coverage at least stays the same before you submit a pull request.

Distributed under the terms of the GPL-2.0 license, "bluetooth-mesh-bluez" is free and open source software.

If you encounter any problems, please file an issue along with a detailed description.