pyeconet

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 on this page — 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

pyeconet on PyPI

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

Evidence: pyeconet-0.2.5-py3-none-any.whl

Keywords: econet, rheem, api

Tags

More Internet packages