---
id: pydrawise
version: "2026.7.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# pydrawise — Python API for interacting with Hydrawise sprinkler controllers.

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

## 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 above — 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

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

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

## Tags

hydrawise api client, sprinkler controller automation, async hydrawise library, iot irrigation control, hydrawise zone management, python sprinkler api, async irrigation control, iot, async, api-client

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