python-bsblan

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 on this page — 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

python-bsblan on PyPI

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

Evidence: python_bsblan-6.1.8-py3-none-any.whl

Keywords: api, async, bsblan, client, thermostat

Tags

More Python Modules packages