aiocamedomotic 1.8.0

Async Python library for interacting with CAME Domotic home automation systems. Provides automatic session management and device control.

Welcome!

The CAME Domotic Library (aiocamedomotic) provides a streamlined Python interface for interacting with CAME Domotic plants, much like the official CAME Domotic app. This library is designed to simplify the management of domotic devices by abstracting the complexities of the CAME Domotic API.

Although primarily developed for use with Home Assistant, the library is freely available under the Apache license 2.0 for anyone interested in experimenting with a CAME Domotic plant.

Important

This library is independently developed and is not affiliated with, endorsed by, or supported by CAME. It may not be compatible with all CAME Domotic systems. While this library is stable and publicly released, it comes with no guarantees. Use at your own risk.

!DANGER!

This library is not intended for use in critical systems, such as security or life-support systems. Always use official and supported tools for such applications.

Key Features

• Simplicity: Easy interaction with domotic entities.

• Automatic session management: No need for manual login or session handling.

• Real-time updates: Built-in long-polling support with typed update classes for monitoring device state changes as they happen.

• First of its kind: Unique in providing integration with CAME Domotic systems.

• Open source: Freely available under the Apache 2.0 license, inviting contributions and adaptations.

Quick Start

Have a look at the following guides to learn how to install and use the library:

• Getting started

• Usage examples

Once you are a bit more familiar with the library, you may want to explore the following resources too:

• API reference

• LLM-friendly docs (also available: full version)

• What’s new (releases)

• Development roadmap

• Security Policy

• Contributing to Our Project

Acknowledgments

Special thanks to Andrea Michielan for his foundational work with the eti_domo library, which greatly facilitated the initial development of this library. We also found great inspiration in the Home Assistant document Building a Python library for an API.

License

This project is licensed under the Apache License 2.0. For more details, see the LICENSE file on GitHub.