aioguardian

What it is and what it does

aioguardian is an asyncio-based client library for controlling and monitoring Elexa Guardian water valves and sensors. It wraps the Guardian device API to let you query valve status, trigger shutoffs, and read sensor data asynchronously from Python code. The library depends on aiohttp for HTTP communication, voluptuous for configuration validation, and several async utilities (asyncio_dgram, frozenlist, yarl) to handle network operations.

The package is designed for integration into home automation systems, monitoring dashboards, or any application that needs to interact with Guardian devices programmatically. It supports Python 3.11 through 3.14 and uses a context-manager pattern for clean resource handling. The aging maintenance status (last release 200 days ago) suggests the library is stable but not actively developed, so expect slower updates if new Guardian hardware or API changes emerge.

Use it for:

• Integrate Guardian water valves into a home automation system to shut off water remotely on leak detection.
• Build a monitoring dashboard that polls Guardian sensors to track water usage and alert on anomalies.
• Create a script that automatically closes Guardian valves based on external triggers or schedules.
• Combine Guardian status with other IoT devices in an async application for coordinated water management.
• Test Guardian device communication in CI/CD pipelines using the library's async API.

Worth the install?

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

An asyncio-focused Python library for communicating with Elexa Guardian water valves and sensors.

Yes, if you own Elexa Guardian devices and need programmatic control from Python. The library is stable, has no known vulnerabilities, and low install friction. The aging maintenance status is a minor concern—updates are infrequent—but the package remains functional for its stated Python versions. Not relevant if you don't use Guardian hardware.

Install

aioguardian on PyPI

pip install aioguardian

uv add aioguardian

poetry add aioguardian

Installing aioguardian

Before you install

Low install friction with a pure-Python wheel distribution. Maintenance status is aging—last release was 200 days ago—so expect slower response to issues, though the package remains functional for its supported Python versions.

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart

pip install aioguardian

import asyncio
from aioguardian import Client

async def main():
    async with Client(host) as client:
        status = await client.valve.status()
        print(status)

Requires Python 3.11 or later; asyncio event loop must be running to use the library.

Verify before relying

• Specific network requirements or authentication details for Guardian device communication.
• Current state of Guardian device compatibility—whether all Elexa models are supported.
• Whether the package works with PyPy implementations despite CPython focus in recent releases.

Package facts

Evidence: aioguardian-2026.1.1-py3-none-any.whl

Tags

More Monitoring packages