aioguardian
A Python3 library for Elexa Guardian water valves and sensors
Decision gist · record as of 2026-08-14
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.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.11 or later; asyncio event loop must be running to use the library.
- 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 · maintenance · safety
MIT (permissive) — 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.
last release 2026-01-26 (200 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 74,469 downloads/mo, #14,828 on PyPI
Alternatives
Verify before relying
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)- 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.
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 on it.
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
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.
Requires Python 3.11 or later; asyncio event loop must be running to use the library.
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)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
| License | MIT permissive |
| Python support | Supports the current Python release >=3.11 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 7 packagesaiohttpasyncio_dgramcertififrozenlisttyping-extensionsvoluptuousyarl |
| Maintenance | Aging 200 days since the last release |
| First released | |
| Downloads | 74,469 / month, #14,828 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | License :: OSI Approved :: Apache Software LicenseProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: aioguardian-2026.1.1-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “guardian water valve control”
- aioguardianAn asyncio-focused Python library for communicating with Elexa…
- aiofloProvides an async Python library for controlling and monitoring Flo…
- pyeconetProvides an async Python interface to the unofficial Rheem EcoNet API…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also aioflo · aionotion · aioambient · iaqualink · p1monitor · aioridwell · aioswitcher · aiorecollect · PyFlume · python-bsblan