boschshcpy

What it is and what it does

boschshcpy is a Python client for controlling Bosch Smart Home Controller devices over the local network using mutual-TLS encryption. It provides both synchronous (requests-based) and asynchronous (aiohttp-based) interfaces, with a long-poll mechanism that fires callbacks when device state changes. The library models the official OpenAPI surface plus several undocumented endpoints that Bosch's own Android app uses—firmware updates, automation rules, and other features—all traced from the official app and real hardware.

The package is designed for direct integration into home automation systems (notably Home Assistant via boschshc-hass) and standalone scripts. It handles device discovery, service state tracking, and connection retry logic transparently. Supported devices include shutters, smart plugs, lights, thermostats, motion detectors, cameras, and various sensors; the library also manages controller-wide operations like firmware updates and intrusion/water-alarm systems.

Use it for:

• Build a Home Assistant integration or custom home automation dashboard that polls Bosch Smart Home devices over the local network without cloud dependency.
• Trigger Bosch device actions (shutter control, light switching, thermostat adjustment) from a Python script or event handler on the same network.
• Monitor firmware updates and device health status (battery level, communication quality, tamper alerts) from a centralized Python application.
• Implement custom automation rules or presence simulation logic that reacts to Bosch sensor state changes via callback subscriptions.
• Integrate Bosch Smart Home devices into a broader home automation platform that requires local-network-only operation for privacy or reliability.

Worth the install?

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

Python client library for the Bosch Smart Home Controller local REST API, communicating directly with the controller over mutual-TLS on the local network without requiring a cloud connection or Bosch account.

Yes. The library is actively maintained, has low install friction, carries no known vulnerabilities, and uses a permissive license. Install it if you own Bosch Smart Home Controller hardware and need programmatic local control without cloud dependency. The reverse-engineered endpoints are explicitly documented as such, so verify compatibility with your specific SHC generation before relying on firmware-update or automation-rule features in production.

Install

boschshcpy on PyPI

pip install boschshcpy

uv add boschshcpy

poetry add boschshcpy

Installing boschshcpy

Before you install

Low friction: pure Python wheel with four runtime dependencies (cryptography, getmac, requests, zeroconf). Actively maintained with a release 9 days ago; repository shows 72 stars and no archived status.

License in practice

BSD 3-Clause (permissive): you may use, modify, and distribute this library freely in commercial and private projects, provided you retain the license notice and disclaimer.

Quickstart

pip install boschshcpy

import boschshcpy

session = boschshcpy.SHCSession("192.168.x.x", "cert.pem", "key.pem")
session.information.summary()
session.start_polling()
# ... your code ...
session.stop_polling()

Requires Python ≥ 3.10. Client certificate registration via boschshc_registerclient CLI tool requires physical access to the SHC device (press front button until LED flashes) and the device password.

Verify before relying

• Whether the library's reverse-engineered endpoints (firmware updates, automation rules, hydraulic balancing) remain stable across SHC firmware versions.
• Real-world performance and reliability of the long-poll mechanism under sustained network interruptions.
• Compatibility with all Bosch Smart Home Controller hardware generations currently in the field.

Package facts

Evidence: boschshcpy-0.6.8-py3-none-any.whl

Keywords: boschshcpy

Tags

More WWW/HTTP packages