---
id: aiounifi
version: "92"
license: MIT
license_treatment: permissive
maintenance: active
---

# aiounifi — Python library for communicating with UniFi Network Controller API

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

## What it is and what it does

aiounifi is an asynchronous Python client for the UniFi Network Controller API. It wraps HTTP communication with the controller using aiohttp, allowing non-blocking queries and updates to UniFi network devices and settings. The library is designed for integration into home automation systems and other applications that need to monitor or control UniFi networks without blocking the event loop.

The package depends on aiohttp for async HTTP transport, orjson for fast JSON parsing, pyotp for OTP-based authentication support, and segno for QR code generation. It targets Python 3.13 and later, reflecting a focus on modern async patterns. The library is actively maintained and classified as production-stable, making it suitable for production deployments in home automation contexts.

Use it for:

- Integrate UniFi network monitoring into home automation platforms.
- Build custom dashboards or management tools that query UniFi controller state asynchronously.
- Automate network device management tasks via Python scripts without blocking.
- Monitor UniFi network metrics and device status in real-time.
- Develop applications that interact with UniFi networks for device discovery or control.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Asynchronous Python library for communicating with UniFi Network Controller API over the network.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and has no known vulnerabilities. It is well-suited for anyone building Python applications that need to communicate with UniFi controllers. The requirement for Python 3.13.0 or later is a constraint to verify against your environment.

## Install

pip install aiounifi
uv add aiounifi
poetry add aiounifi

## Installing aiounifi

Before you install: Low install friction with a pure-Python wheel distribution. Active maintenance with a recent release 39 days ago and ongoing commits; the project is not archived and has modest community engagement at 89 stars.

License in practice: MIT license is permissive, allowing commercial and private use with minimal restrictions—you may use, modify, and distribute this package freely provided you retain the license notice.

Quickstart:

pip install aiounifi
import aiounifi
# Requires aiohttp, orjson, pyotp, segno as runtime dependencies
await aiounifi.Controller(host, username, password).login()

Requires Python 3.13.0 or later; aiohttp, orjson, pyotp, and segno must be installed.

Verify before relying:

- Whether the library supports all current UniFi Controller versions or has known compatibility gaps.
- Whether aiohttp, orjson, pyotp, and segno are all required at runtime or if some are optional.
- Performance characteristics and typical response times for common operations.

## Package facts

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

## Tags

unifi controller api client, async unifi network communication, homeassistant unifi integration, unifi device management, unifi controller python library, asynchronous network controller, unifi api async, home-automation, async-http, network-management

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