---
id: pyeconet
version: "0.2.5"
license: unclear
license_treatment: permissive
maintenance: active
---

# pyeconet — Interface to the unofficial EcoNet API

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

## What it is and what it does

pyeconet is an async Python client for the unofficial Rheem EcoNet cloud API, allowing you to query and control Rheem water heaters and thermostats remotely. It wraps the EcoNet API behind a Python interface that uses aiohttp for async HTTP calls and paho-mqtt for potential MQTT integration.

The package is built around an EcoNetApiInterface class that handles login, device discovery by type, and equipment state queries. It depends on aiohttp and paho-mqtt as runtime dependencies. The maintainer has stepped back from active use and is seeking new ownership, so while the code is actively maintained on GitHub, the unofficial nature of the API means Rheem could change or revoke access at any time without notice.

Use it for:

- Integrate Rheem water heaters or thermostats into a home automation system via async Python code.
- Query current state and settings of Rheem equipment from a local application or service.
- Build monitoring or alerting logic around Rheem device status and energy usage.
- Control water heater operation modes or thermostat setpoints programmatically.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides an async Python interface to the unofficial Rheem EcoNet API for querying and controlling water heaters and thermostats.

Yes, if you own Rheem EcoNet equipment and need programmatic async control or monitoring. The low install friction, permissive license, and active codebase make it straightforward to adopt. However, be aware that the maintainer no longer actively uses the package and is seeking new ownership, and the unofficial API carries inherent risk of breaking changes from Rheem without warning.

## Install

pip install pyeconet
uv add pyeconet
poetry add pyeconet

## Installing pyeconet

Before you install: Low install friction with only two runtime dependencies (aiohttp, paho-mqtt). Actively maintained as of July 2026, though the maintainer notes they no longer have an active device and are seeking new ownership.

License in practice: Licensed under MIT (permissive), so you can use, modify, and distribute this package freely with minimal restrictions.

Quickstart:

import asyncio
from pyeconet import EcoNetApiInterface
from pyeconet.equipment import EquipmentType

async def main():
    api = await EcoNetApiInterface.login(email, password=password)
    equipment = await api.get_equipment_by_type([EquipmentType.WATER_HEATER])

asyncio.run(main())

Requires Python 3.8 or later. Unofficial API—Rheem could change or block access without warning.

Verify before relying:

- Current stability and whether the unofficial API endpoint remains accessible and unchanged
- Whether new ownership or maintenance has been established since the maintainer's note

## Package facts

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

## Tags

rheem econet api python, water heater thermostat control, async home automation api, econet device integration, rheem cloud api client, home-automation, async-api, device-control

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