pyoverkiz
A fully asynchronous API client for interaction with smart devices connected to OverKiz, supporting multiple vendors such as Somfy TaHoma and Atlantic Cozytouch.
Decision gist · record as of 2026-08-14
Yes. The package is actively maintained, has no known vulnerabilities, low install friction, and a permissive MIT license. It is well-suited for anyone building Home Assistant integrations or custom automation around OverKiz-compatible smart home hubs. The requirement for Python 3.12+ is a minor constraint but reasonable for new projects.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.12 or later; OverKiz account credentials and network access to OverKiz servers or a local gateway.
- Low install friction with a pure-Python wheel and four lightweight runtime dependencies (aiohttp, attrs, backoff, cattrs).
- Actively maintained with a release within the last 2 days and no known vulnerabilities.
License · maintenance · safety
MIT (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
last release 2026-08-12 (2 days) · last repo commit 2026-08-12 · 57 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 83,877 downloads/mo, #14,042 on PyPI
Alternatives
Verify before relying
pip install pyoverkiz
import asyncio
from pyoverkiz.auth.credentials import UsernamePasswordCredentials
from pyoverkiz.client import OverkizClient
from pyoverkiz.enums import Server
async def main():
async with OverkizClient(
server=Server.SOMFY_EUROPE,
credentials=UsernamePasswordCredentials("username", "password"),
) as client:
await client.login()
devices = await client.get_devices()
for device in devices:
print(f"{device.label} - {device.controllable_name}")
asyncio.run(main())- Whether local API support is available for all listed vendors or only specific gateway models.
- Performance characteristics when managing large numbers of devices or frequent command execution.
- Real-world latency and reliability of cloud vs. local API connections.
What it is and what it does
pyoverkiz is a fully asynchronous Python client for the OverKiz API, designed to control smart devices connected to OverKiz-compatible hubs. It abstracts the complexity of cloud and local API communication, supporting multiple vendors including Somfy (TaHoma, Connexoon), Atlantic Cozytouch, Rexel Energeasy Connect, and others. The package is built on aiohttp for async HTTP operations and uses attrs and cattrs for data modeling and serialization.
The client handles authentication (username/password or OAuth), device discovery, command execution, and event listening. It is primarily used by Home Assistant's Overkiz integration but can be used standalone for custom automation projects. The package requires Python 3.12+ and is actively maintained with no known security vulnerabilities.
Use it for
- Build a Home Assistant custom component or integration to control Somfy TaHoma or Atlantic Cozytouch devices.
- Create a command-line tool or automation script to query and control OverKiz-compatible smart home devices.
- Bridge OverKiz devices to MQTT or other protocols for cross-platform home automation.
- Develop a local-first smart home controller using the local API for devices that support it.
- Monitor device state changes and react to events from OverKiz hubs in real-time.
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 known vulnerabilities, low install friction, and a permissive MIT license. It is well-suited for anyone building Home Assistant integrations or custom automation around OverKiz-compatible smart home hubs. The requirement for Python 3.12+ is a minor constraint but reasonable for new projects.
Install
pyoverkiz on PyPI
Before you install
Low install friction with a pure-Python wheel and four lightweight runtime dependencies (aiohttp, attrs, backoff, cattrs). Actively maintained with a release within the last 2 days and no known vulnerabilities.
Requires Python 3.12 or later; OverKiz account credentials and network access to OverKiz servers or a local gateway.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions—suitable for both open-source and commercial projects.
Quickstart
pip install pyoverkiz
import asyncio
from pyoverkiz.auth.credentials import UsernamePasswordCredentials
from pyoverkiz.client import OverkizClient
from pyoverkiz.enums import Server
async def main():
async with OverkizClient(
server=Server.SOMFY_EUROPE,
credentials=UsernamePasswordCredentials("username", "password"),
) as client:
await client.login()
devices = await client.get_devices()
for device in devices:
print(f"{device.label} - {device.controllable_name}")
asyncio.run(main())Verify before relying
- Whether local API support is available for all listed vendors or only specific gateway models.
- Performance characteristics when managing large numbers of devices or frequent command execution.
- Real-world latency and reliability of cloud vs. local API connections.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release <4.0,>=3.12 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesaiohttpattrsbackoffcattrs |
| Maintenance | Actively maintained 2 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 83,877 / month, #14,042 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: pyoverkiz-2.1.1-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 › “overkiz api client”
- pyoverkizAn asynchronous Python client for the OverKiz API that enables…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
- twentyc.rpcA client library for consuming 20c's RESTful API, built on top of the…
Give your agent the search over MCP, or paste the wish link into any chat.
More Internet packages
Botocore provides low-level, data-driven access to Amazon Web Services APIs, serving as the foundation for the AWS CLI and boto3 libraries.
Install it if you need programmatic access to AWS services.
Provides an async client for AWS services using botocore and aiohttp, allowing you to call AWS APIs asynchronously within asyncio-based applications.
Install it if you need to call AWS services from async Python code; it is the standard way to do so.
Pydantic validates Python data structures against type hints, coercing and checking input at runtime to ensure it matches a declared schema.
Provides a platform-independent file locking mechanism to coordinate access to files across processes and threads.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides common Protocol Buffer message definitions used across Google Cloud APIs, enabling Python clients to interact with Google services.
See also pysensibo · aiohomekit · pyswitchbee · aiohue · pyvesync · homematicip · pyfibaro · HATasmota · elmax-api · jellyfin-apiclient-python