home-connect-async

What it is and what it does

home-connect-async is a high-level async Python client for the BSH Home Connect API, which controls and monitors home appliances sold under Bosch, Siemens, Gaggenau, and Neff branding. It abstracts the OAuth2 authentication flow and REST API calls into a data model, then maintains a live-updating state by subscribing to real-time events from the API—so you can start a washer cycle and receive notifications when it completes, all without polling.

The package is built on aiohttp for async HTTP, aiohttp-sse-client for server-sent events, oauth2-client for credential handling, and dataclasses-json for serialization. It's actively maintained, carries no known vulnerabilities, and is licensed under MIT. The main prerequisite is registering a developer account at https://developer.home-connect.com to obtain OAuth2 credentials.

Use it for:

• Start or stop appliance programs (e.g., washing machine cycles) and receive completion notifications.
• Monitor real-time appliance status and settings without polling the API.
• Build a home automation dashboard that displays and controls multiple BSH appliances.
• Integrate BSH appliances into a broader smart-home orchestration system.
• Log appliance events and energy usage for analytics or billing purposes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

An async Python SDK that connects to the BSH Home Connect API to monitor and control home appliances from brands like Bosch, Siemens, Gaggenau, and Neff, maintaining real-time state through subscriptions.

Yes. The package is actively maintained, has low install friction, carries no security vulnerabilities, and solves a specific problem—async control and monitoring of BSH Home Connect appliances—with a clean API. The main requirement is obtaining developer credentials from Home Connect; if you own compatible appliances and need programmatic access, this is the right tool.

Install

home-connect-async on PyPI

pip install home-connect-async

uv add home-connect-async

poetry add home-connect-async

Installing home-connect-async

Before you install

Low install friction with a pure-wheel distribution. Actively maintained with a recent release (90 days ago) and ongoing commits. Five runtime dependencies are all well-established async/HTTP libraries.

License in practice

MIT license is permissive; you can use, modify, and distribute this package with minimal restrictions, only requiring attribution and inclusion of the license notice.

Quickstart

pip install home-connect-async

import asyncio
from home_connect_async import HomeConnectClient

async def main():
    client = HomeConnectClient(client_id, client_secret, redirect_uri)
    await client.authenticate()
    appliances = await client.get_appliances()

asyncio.run(main())

Requires a registered Home Connect developer account and OAuth2 credentials (client ID, secret, redirect URI) from https://developer.home-connect.com.

Verify before relying

• Whether the SDK supports all BSH appliance types or only a subset of Home Connect-enabled models.
• Specific Python version requirements (classifiers list 3.12–3.14 but requires_python is unspecified).
• Whether real-time subscription updates work reliably across all network conditions or have known limitations.

Package facts

Evidence: home_connect_async-0.8.6-py3-none-any.whl

Keywords: HomeConnect, Home Connect, BSH, Async, SDK

Tags

More Build Tools packages