---
id: pyimouapi
version: "1.3.5"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyimouapi — A package for imou open api

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

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

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

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

## Tags

imou cloud api client, async imou device control, imou open platform python, imou camera api, imou device manager, imou authentication client, imou channel control, async-http, device-integration, home-automation

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