plugwise

What it is and what it does

Plugwise is a Python backend module for controlling networked Plugwise smart home devices—primarily heating hubs like Adam, Anna, P1, and Stretch. It abstracts the device communication protocol, allowing Home Assistant and other applications to read sensor data and send control commands over the network. The module uses async I/O (aiohttp, aiofiles) to handle concurrent device interactions and relies on defusedxml for safe XML parsing and munch for convenient data access.

The package is maintained as the official backend for Home Assistant's Plugwise component and is actively developed. It supports current Python versions and has no known security vulnerabilities. Installation is straightforward with low dependency friction, making it suitable for integration into home automation systems.

Use it for:

• Integrate Plugwise heating hubs (Adam, Anna) into Home Assistant for centralized smart home control.
• Build custom home automation scripts that read temperature and energy data from Plugwise P1 meters.
• Control Stretch devices and their connected Circles from a Python application.
• Develop monitoring dashboards that pull real-time sensor readings from networked Plugwise equipment.
• Create automation rules that respond to Plugwise device state changes in Home Assistant.

Worth the install?

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

Provides Python interface to networked Plugwise devices (Adam, Anna, P1, Stretch hubs) for reading and controlling smart home heating and energy systems.

Yes. The package is actively maintained, has no security vulnerabilities, uses permissive MIT licensing, and offers low install friction. It is the official backend for Home Assistant's Plugwise integration and is suitable for anyone building home automation around networked Plugwise devices. Install if you own compatible Plugwise hardware and want to integrate it with Home Assistant or build custom Python automation.

Install

plugwise on PyPI

pip install plugwise

uv add plugwise

poetry add plugwise

Installing plugwise

Before you install

Low install friction with five straightforward dependencies. Actively maintained with a recent commit and release. Supports current Python versions.

License in practice

MIT license permits commercial and private use with minimal restrictions, making it suitable for integration into Home Assistant and other projects.

Quickstart

pip install plugwise

import asyncio
from plugwise import Smile

async def main():
    smile = Smile(host='your-device-ip')
    await smile.connect()
    # Interact with Plugwise device

asyncio.run(main())

Requires Python 3.13 or later; designed for async/await usage with aiohttp for network communication.

Verify before relying

• Whether the module works with Plugwise devices other than those explicitly listed (Adam, Anna, P1, Stretch, Circles).
• Current state of the ongoing refactoring toward multiple components under an umbrella integration.
• Whether USB-based Plugwise devices are supported or require the separate plugwise-usb component.
• Specific configuration parameters and authentication methods required to connect to devices.

Package facts

Evidence: plugwise-1.14.6-py3-none-any.whl

Keywords: home, automation, plugwise, module

Tags

More Home Automation packages