asusrouter

What it is and what it does

Asusrouter is a Python library that wraps the HTTP API of ASUSWRT-powered routers, enabling programmatic access to router configuration, status, and control functions. It uses async/await patterns via aiohttp to communicate with routers over HTTP or HTTPS, parsing responses with xmltodict. The library is designed primarily for Home Assistant integrations but can be used standalone in any async Python application that needs to interact with ASUS routers.

The package supports a wide range of ASUS router models across WiFi standards (WiFi 6, 6e, and 7), with both stock ASUSWRT and AsusWRT-Merlin firmware. It abstracts away the low-level HTTP protocol details and XML parsing, exposing a simple async API for querying network data and managing router settings. Installation is straightforward with minimal dependencies, and the codebase is actively maintained.

Use it for:

• Monitor network status and connected device information from an ASUS router in a Home Assistant automation.
• Query WiFi performance metrics and signal strength data for reporting or alerting systems.
• Programmatically reboot or reconfigure ASUS router settings from a custom network management tool.
• Build a dashboard that aggregates real-time router statistics and client connection logs.
• Integrate ASUS router telemetry into a broader IoT monitoring platform using async Python.

Worth the install?

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

Asynchronous API wrapper for querying and controlling ASUSWRT-powered routers over HTTP(S), supporting both stock firmware and AsusWRT-Merlin variants.

Yes, if you own an ASUS router and need programmatic access to it from Python. Low install friction, active maintenance, permissive license, and no known vulnerabilities make it a safe choice. The async design fits well into modern Python applications. Verify that your specific router model and firmware version are supported before relying on it for production automation.

Install

asusrouter on PyPI

pip install asusrouter

uv add asusrouter

poetry add asusrouter

Installing asusrouter

Before you install

Low install friction; pure Python wheel with three common async/HTTP dependencies (aiohttp, urllib3, xmltodict). Actively maintained with recent commits; requires Python 3.11 or later.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most integration and automation scenarios.

Quickstart

pip install asusrouter

import aiohttp
import asyncio
from asusrouter import AsusRouter, AsusData

loop = asyncio.new_event_loop()
session = aiohttp.ClientSession(loop=loop)
router = AsusRouter(hostname="router.my.address", username="admin", password="password", session=session)
loop.run_until_complete(router.async_connect())
data = loop.run_until_complete(router.async_get_data(AsusData.NETWORK))
loop.run_until_complete(router.async_disconnect())
loop.run_until_complete(session.close())

Requires Python 3.11 or later; must provide valid router hostname, username, and password; aiohttp event loop and session management required.

Verify before relying

• Whether all ASUSWRT device models are actually supported or only those explicitly listed in documentation.
• Performance characteristics and timeout behavior under high-frequency polling or large data queries.
• Compatibility with custom firmware versions beyond the tested firmware versions shown in the device tables.

Package facts

Evidence: asusrouter-1.21.3-py3-none-any.whl

Tags

More Libraries packages