plugwise
Plugwise Smile (Adam/Anna/P1) and Stretch module for Python 3.
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.13 or later; designed for async/await usage with aiohttp for network communication.
- Low install friction with five straightforward dependencies.
- Actively maintained with a recent commit and release.
License · maintenance · safety
MIT (permissive) — MIT license permits commercial and private use with minimal restrictions, making it suitable for integration into Home Assistant and other projects.
last release 2026-08-12 (2 days) · last repo commit 2026-08-14 · 14 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 80,090 downloads/mo, #14,321 on PyPI
Alternatives
Verify before relying
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())- 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.
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 on it.
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
Before you install
Low install friction with five straightforward dependencies. Actively maintained with a recent commit and release. Supports current Python versions.
Requires Python 3.13 or later; designed for async/await usage with aiohttp for network communication.
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())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
| License | MIT permissive |
| Python support | Supports the current Python release >=3.13 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 5 packagesaiofilesaiohttpdefusedxmlmunchpython-dateutil |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 80,090 / month, #14,321 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersOperating System :: OS IndependentProgramming Language :: Python :: 3.13Programming Language :: Python :: 3.14Topic :: Home Automation |
Evidence: plugwise-1.14.6-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “plugwise python api”
- plugwiseProvides Python interface to networked Plugwise devices (Adam, Anna,…
- xdkA Python SDK for interacting with the X API, providing typed client…
- sailthru-clientA Python client library for the Sailthru REST API, enabling remote…
Give your agent the search over MCP, or paste the wish link into any chat.
More Home Automation packages
Represents and manipulates IPv4, IPv6, MAC addresses and related network objects; supports CIDR notation, subnetting, set operations, IANA lookups, and DNS reverse generation.
Home Assistant is an open-source home automation platform that centralizes control of smart home devices and automations on a local server or Raspberry Pi, prioritizing local control and privacy over cloud dependency.
Defines finite state machines and statecharts with a declarative Python API, supporting flat states, compound hierarchies, parallel regions, history states, guards, and both sync and async callbacks.
Install it if you need to model workflows, control logic, or any system with discrete states and event-driven transitions — from simple state machines to complex…
A Python library for controlling BlueZ Bluetooth adapters on Linux via the Management API, supporting both synchronous and event-driven command patterns.
An async Python library for controlling and monitoring Homematic and HomematicIP devices through multiple backend systems (CCU3, OpenCCU, Homegear, CUxD, CCU-Jack) using XML-RPC and JSON-RPC protocols.
Install it if you need to control Homematic devices from Python; the only constraint is a requirement for Python 3.14 or later and network access to a compatible…
Provides base classes and utilities for Home Assistant integrations to proxy HTTP and WebSocket traffic through Home Assistant's web server.
Install only if you are building a custom Home Assistant integration; it is not useful as a standalone package.
See also wiim · AlexaPy · python-ecobee-api · aiohomekit · ha-mcp · adext · ha-mcp-dev · p1monitor