---
id: python-bsblan
version: "6.1.8"
license: MIT
license_treatment: permissive
maintenance: active
---

# python-bsblan — Asynchronous Python client for BSBLAN API

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

## What it is and what it does

python-bsblan is an async HTTP client library for BSBLan heating control devices. It abstracts the BSBLan JSON API, allowing you to read device state (temperatures, operating modes) and send commands (set thermostat targets, control hot water) from Python code. The library automatically detects device capabilities during initialization and adapts its feature set based on the reported JSON-API version: full support for version 2.0+ (multiple circuits, schedules, cooling modes) or reduced single-circuit support for version 1.x. It depends on aiohttp for async HTTP, pydantic for response validation, yarl for URL handling, python-backoff for retry logic, and packaging for version parsing.

The package targets developers building home automation, energy management, or HVAC monitoring systems that need to integrate with BSBLan hardware. It is actively maintained, requires Python 3.12+, and carries no known security vulnerabilities. The MIT license imposes no restrictions on commercial use.

Use it for:

- Automate heating setpoints based on time-of-day or occupancy sensors in a smart home system.
- Monitor current and historical temperature readings from multiple heating zones for energy analysis.
- Integrate BSBLan device control into a home assistant or custom orchestration platform.
- Build a web dashboard that displays real-time device state and accepts remote control commands.
- Trigger hot water heating or cooling mode changes in response to external events or schedules.

## Worth the install?

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

Asynchronous Python client for controlling and monitoring BSBLan heating devices over HTTP, supporting multiple circuits, hot water control, and automatic device capability detection.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive MIT license. It is well-suited for developers building BSBLan integrations or home automation systems. The requirement for Python 3.12+ and a compatible BSBLan device are the only practical constraints.

## Install

pip install python-bsblan
uv add python-bsblan
poetry add python-bsblan

## Installing python-bsblan

Before you install: Low install friction with a pure-wheel distribution. Active maintenance with a release 9 days ago and commits through 2026-08-13. Requires Python 3.12 or newer.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install python-bsblan

import asyncio
from bsblan import BSBLAN, BSBLANConfig

async def main():
    config = BSBLANConfig(host="192.168.1.100")
    async with BSBLAN(config) as client:
        state = await client.state()
        print(f"Temperature: {state.current_temperature.value}")

Requires Python 3.12 or newer; target BSBLan device must expose JSON-API version 1.0 or higher.

Verify before relying:

- Whether the package works with BSBLan devices running JSON-API versions below 1.0 despite the documented incompatibility.
- Performance characteristics when controlling multiple heating circuits simultaneously.
- Network timeout and retry behavior beyond what python-backoff provides by default.

## Package facts

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

## Tags

bsblan api client, heating system control python, thermostat automation async, bsblan device monitoring, home heating integration, async-http-client, home-automation, hvac-control

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