---
id: aiobmsble
version: "0.27.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# aiobmsble — Asynchronous Python library to query battery management systems via Bluetooth Low Energy.

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

## What it is and what it does

Aiobmsble is an async Python library built on Bleak that communicates with battery management systems via Bluetooth Low Energy. It handles the complexity of BMS protocol detection and device identification, allowing you to query battery data like voltage, current, temperature, and state-of-charge from compatible devices. The library supports autodetection of compatible BMSs and automatic detection of compatible BLE write modes, making it straightforward to integrate into monitoring applications.

The library is designed for non-safety-critical monitoring and telemetry—the documentation explicitly warns against using it for safety-relevant operations like preventing battery damage or fire, since correctness cannot be guaranteed due to reliance on vendor specifications and Bluetooth connection variability. It provides both command-line tools for device discovery and a Python API for programmatic use, with full async/await support for querying multiple batteries in parallel.

Use it for:

- Monitor battery status in Home Assistant via the BMS_BLE-HA integration for smart home energy management
- Query real-time battery metrics (voltage, current, temperature) from portable power systems or UPS devices
- Build a battery fleet monitoring dashboard that polls multiple BMS devices concurrently over Bluetooth
- Integrate battery telemetry into IoT applications running on Linux or Raspberry Pi systems
- Autodetect and log battery management system data for diagnostics or historical analysis

## Worth the install?

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

Asynchronous Python library for querying battery management systems over Bluetooth Low Energy, with support for device autodetection and parallel operation.

Yes, if you need to read battery management system data over Bluetooth and your devices are on the supported list. The library is actively maintained, has low install friction, and carries a permissive license. However, verify that your specific BMS model is supported before committing, and do not rely on it for safety-critical battery protection—use it only for monitoring and telemetry.

## Install

pip install aiobmsble
uv add aiobmsble
poetry add aiobmsble

## Installing aiobmsble

Before you install: Low friction installation with only two runtime dependencies (bleak and bleak-retry-connector). Actively maintained with a release within the past week and recent commits, though the project is still in Beta status.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.

Quickstart:

pip install aiobmsble

import asyncio
from bleak import BleakScanner
from aiobmsble.bms.dummy_bms import BMS

async def main():
    device = await BleakScanner.find_device_by_name("BT Device Name")
    async with BMS(ble_device=device) as bms:
        data = await bms.async_update()
        print(data)

Requires Python 3.12 or later and a Bluetooth adapter; BMS device must be on the supported devices list.

Verify before relying:

- Whether the supported BMS device list is comprehensive enough for your specific hardware
- Real-world reliability of Bluetooth connection stability under interference or distance constraints
- Performance characteristics when querying multiple batteries in parallel

## Package facts

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

## Tags

bluetooth battery management system, BLE BMS query library, async battery monitoring, bluetooth low energy battery, BMS data retrieval asyncio, wireless battery status, BLE device communication, bluetooth-iot, battery-monitoring, asyncio

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