---
id: unifi-discovery
version: "1.5.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# unifi-discovery — Discover Unifi Devices

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

## What it is and what it does

Unifi Discovery is a Python library for finding Unifi devices on a network. It uses async I/O via aiohttp and network routing information via pyroute2 to scan for and enumerate available Unifi hardware. The package is in pre-alpha development status and targets Python 3.11 through 3.14.

The library is designed for developers building network management or monitoring tools that need to locate Unifi devices programmatically. It provides an async-first interface suitable for integration into larger network discovery or automation workflows.

Use it for:

- Automatically detect available Unifi devices when setting up a network management dashboard
- Build a network inventory tool that scans for and catalogs Unifi hardware on startup
- Integrate device discovery into a monitoring system that tracks Unifi device availability
- Create an async network scanner that discovers Unifi devices without blocking other operations

## Worth the install?

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

Discovers Unifi devices on a network using async I/O, returning information about available Unifi hardware.

Yes, with conditions. The package is actively maintained and has low install friction, but it is in pre-alpha status (Development Status :: 2), so expect API changes and incomplete features. Install if you need Unifi device discovery in a network tool and can tolerate early-stage software; avoid if you need production-grade stability.

## Install

pip install unifi-discovery
uv add unifi-discovery
poetry add unifi-discovery

## Installing unifi-discovery

Before you install: Low install friction with a pure Python wheel and only two runtime dependencies (aiohttp and pyroute2). Actively maintained with a recent commit on 2026-08-10.

License in practice: Licensed under Apache-2.0 (permissive), allowing commercial and private use with minimal restrictions.

Quickstart:

pip install unifi-discovery

import unifi_discovery
# See aioscanner.py example in project repository for usage

Requires Python 3.11 or later (supports 3.11, 3.12, 3.13, 3.14); pyroute2 may require system-level network access

Verify before relying:

- What specific Unifi device types or models are supported by this discovery mechanism
- Whether the package requires elevated network-level privileges or specific system permissions
- Performance characteristics and scalability limits for large networks

## Package facts

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

## Tags

unifi device discovery, network device scanner, unifi hardware detection, async network scanning, unifi device enumeration, network-discovery, async-io, unifi

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