---
id: aiopvapi
version: "3.4.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# aiopvapi — Powerview blinds API wrapper

License: permissive · Maintenance: active · Downloads: 76.9K/mo

## 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 above — 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

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

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 76.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

powerview blinds api, hunter douglas motorized shades, async blind control, powerview home automation, iot blind control library, asyncio smart home blinds, powerview hub integration, home-automation, iot, asyncio

[View on SkillFed](https://skillfed.io/packages/aiopvapi) · [View on PyPI](https://pypi.org/project/aiopvapi/)