pydrawise

What it is and what it does

Pydrawise is a Python 3 async library that wraps the Hydrawise sprinkler controller API, letting you programmatically query and control irrigation zones and controllers. It uses aiohttp and graphql-core to communicate with Hydrawise's backend, and is built for modern Python versions (3.11+). The library is not officially affiliated with Hydrawise or Hunter, so you use it at your own risk.

Typical workflows involve authenticating with your Hydrawise account credentials, fetching the list of controllers and zones attached to your account, and then issuing commands like starting or stopping zones. The async design means you can manage multiple controllers or zones concurrently without blocking. It's useful for home automation, smart irrigation scheduling, or integrating sprinkler control into broader IoT systems.

Use it for:

• Automate irrigation scheduling based on weather data or soil moisture sensors.
• Integrate Hydrawise zone control into a home automation platform or smart home hub.
• Build a custom dashboard or mobile app to monitor and control sprinklers remotely.
• Programmatically manage multiple Hydrawise controllers across different properties.
• Log zone activity and water usage for billing or conservation tracking.

Worth the install?

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

Pydrawise is an asynchronous Python library for controlling Hydrawise sprinkler controllers via their API, allowing you to query and manage zones and controllers programmatically.

Yes, if you own Hydrawise controllers and need programmatic access. The package is actively maintained, has no known vulnerabilities, uses a permissive license, and requires only standard dependencies. The main caveat is the lack of official Hydrawise support—verify compatibility with your controller model before relying on it in production.

Install

pydrawise on PyPI

pip install pydrawise

uv add pydrawise

poetry add pydrawise

Installing pydrawise

Before you install

Installation is straightforward with low friction; the package is actively maintained with a recent release (27 days old) and current repository activity. Five runtime dependencies (aiohttp, apischema, gql, graphql-core, requests) are all well-established libraries.

License in practice

Licensed under Apache-2.0 (permissive), so you can use, modify, and distribute the package freely in commercial or private projects without copyleft obligations.

Quickstart

pip install pydrawise

import asyncio
from pydrawise import Auth, Hydrawise

async def main():
    h = Hydrawise(Auth("username", "password"))
    controllers = await h.get_controllers()
    zones = await h.get_zones(controllers[0])
    await h.start_zone(zones[0])

asyncio.run(main())

Requires Python 3.11 or later; Hydrawise account credentials needed to authenticate.

Verify before relying

• Whether the library supports all Hydrawise controller models and firmware versions.
• Rate limiting or throttling behavior when making repeated API calls.
• Error handling and recovery strategies for network failures or API outages.
• Whether authentication credentials can be refreshed without re-instantiating the Hydrawise object.

Package facts

Evidence: pydrawise-2026.7.0-py3-none-any.whl

Keywords: hydrawise, api, iot

Tags

More Python Modules packages