pyimouapi

What it is and what it does

pyimouapi is an async Python client for Imou's Open Platform cloud APIs, built on aiohttp. It abstracts authentication, token lifecycle, and HTTP signing so you can focus on device operations. The package exposes a device manager for listing and controlling Imou devices and channels, plus higher-level helpers (ImouHaDeviceManager) designed for home automation integrations like Home Assistant. It handles PTZ control, alarms, storage queries, and collection point (preset) management through typed exceptions and device abstractions.

The package is structured into focused modules: the core client handles auth and requests, the device module provides device and channel abstractions, and the ha_device module offers aggregated device models for automation stacks. It requires Python >= 3.11 and depends only on aiohttp and simpleeval, keeping the install footprint small. Intended for integrations that need programmatic control over Imou devices via the cloud platform.

Use it for:

• Build a Home Assistant integration or other home automation system that discovers and controls Imou cameras and devices.
• Query device status, alarms, and storage metrics from Imou cameras programmatically in an async application.
• Implement PTZ (pan-tilt-zoom) control or preset management for Imou cameras via the cloud API.
• Aggregate multiple Imou devices into a unified device model for a custom dashboard or monitoring tool.
• Automate collection point (preset) switching on Imou devices based on external triggers or schedules.

Worth the install?

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

Async Python client for Imou Open Platform cloud APIs, providing authentication, device management, and channel control through aiohttp-based HTTP calls.

Yes, if you need to integrate Imou devices into a Python application. Low install friction, active maintenance (released within 1 day), permissive MIT license, and no known vulnerabilities make it a safe choice. Verify that the package covers the specific Imou endpoints and device types you need before committing to a production integration.

Install

pyimouapi on PyPI

pip install pyimouapi

uv add pyimouapi

poetry add pyimouapi

Installing pyimouapi

Before you install

Active maintenance with a release within the last day. Low install friction: pure Python wheel with only two runtime dependencies (aiohttp and simpleeval). Requires Python >= 3.11.

License in practice

MIT license permits commercial and private use with minimal restrictions—suitable for most integration scenarios.

Quickstart

pip install pyimouapi

from pyimouapi.openapi import ImouOpenApiClient

client = ImouOpenApiClient("app_id", "app_secret", "openapi-sg.easy4ip.com")
await client.async_get_token()

Requires Python >= 3.11 and an async runtime (asyncio). Imou Open Platform credentials (app ID, app secret, and gateway hostname) are required.

Verify before relying

• Whether the package is actively maintained by Imou or community-driven (repo shows 0 stars, unclear ownership signal).
• API stability and coverage—which Imou endpoints are fully supported versus experimental or partial.

Package facts

Evidence: pyimouapi-1.3.5-py3-none-any.whl

Tags

More Internet packages