aiopvapi

What it is and what it does

AioPvApi is an asyncio-based HTTP client for PowerView motorized blinds, designed originally for Home-Assistant integration. It wraps the PowerView hub API to query and control individual shades, manage scenes, automations, and schedules across multiple hub generations. The library handles shade type detection, position clamping, battery status, and cross-generational API differences transparently.

The package depends only on aiohttp for HTTP requests and is built around async/await patterns, making it suitable for event-driven home automation systems. Recent releases have focused on bug fixes for edge cases (empty hub responses, case-sensitive endpoints, tilt-shade positioning) and support for additional shade types. It exposes structured data objects rather than raw JSON, and includes automatic API version detection based on firmware.

Use it for:

• Integrate PowerView blinds into Home-Assistant for scheduled or voice-controlled operation.
• Build a custom home automation dashboard that queries and controls multiple shades via a local hub.
• Monitor blind battery levels and position status as part of a broader IoT monitoring system.
• Implement scene-based lighting control by coordinating blind position with other smart home devices.
• Develop a backend that manages motorized blinds through a hub on the home network.

Worth the install?

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

Async Python API client for PowerView motorized blinds, enabling remote control and status queries over HTTP.

Yes, if you own PowerView blinds and need programmatic control. The library is actively maintained, has low dependencies, carries no known vulnerabilities, and is permissively licensed. Install friction is minimal. The main gotcha is that it requires a PowerView hub on your local network—it is not a cloud API. Suitable for Home-Assistant users or custom automation projects.

Install

aiopvapi on PyPI

pip install aiopvapi

uv add aiopvapi

poetry add aiopvapi

Installing aiopvapi

Before you install

Low install friction with a single runtime dependency (aiohttp). Active maintenance: released 2 days ago with recent bug fixes and API improvements. Repository shows ongoing development.

License in practice

MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both personal and commercial projects.

Quickstart

pip install aiopvapi

import asyncio
from aiopvapi.hub import Hub

async def main():
    hub = Hub("hub_ip_address")
    await hub.get_shades()

asyncio.run(main())

Requires a PowerView hub on the local network and Python 3.5 or later.

Verify before relying

• Whether the package supports all current PowerView hub generations or only specific versions.
• Real-world latency and reliability characteristics when controlling multiple shades simultaneously.
• Whether Home-Assistant integration is maintained as a separate module or bundled here.

Package facts

Evidence: aiopvapi-3.4.1-py3-none-any.whl

Tags

More WWW/HTTP packages