aioflo

What it is and what it does

aioflo is an asyncio-based Python client library for the Flo by Moen Smart Water Detector API. It wraps HTTP calls to Flo's backend, allowing you to query account and device information, retrieve water consumption metrics, control shutoff valves, run health tests, and switch device operating modes (Home, Away, Sleep) programmatically. The library is built on aiohttp and supports connection pooling for efficient batch operations.

The package targets Python 3.6 through 3.10 and is distributed as a pure-Python wheel with minimal dependencies. It is designed for integration into home automation systems, monitoring dashboards, or scripts that need to interact with Flo devices without blocking. However, the project has been abandoned since late 2023, meaning no updates are planned for API changes, new device features, or compatibility with newer Python versions.

Use it for:

• Integrate Flo water detector status and metrics into a home automation platform or dashboard.
• Automatically close the shutoff valve in response to detected leaks or when leaving home.
• Retrieve historical water consumption data for analysis or billing reconciliation.
• Monitor device health and trigger alerts based on test results or anomalies.
• Switch device modes (Home/Away/Sleep) programmatically as part of a larger smart-home workflow.

Worth the install?

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

Provides an async Python library for controlling and monitoring Flo by Moen Smart Water Detectors via their API, including valve operations, consumption tracking, and device modes.

Yes, if you own a Flo device and need async Python bindings to its API and are comfortable with an unmaintained package. The code is stable and has no known vulnerabilities, but you should verify that the Flo API has not changed significantly since November 2021. If you require ongoing support or compatibility with future Python or Flo API versions, consider whether the project's abandonment is acceptable for your use case.

Install

aioflo on PyPI

pip install aioflo

uv add aioflo

poetry add aioflo

Installing aioflo

Before you install

Low install friction with a single runtime dependency (aiohttp). However, the package is abandoned—last release was 2021-11-28 and last commit 2023-08-22. No active maintenance means bug fixes or compatibility updates with newer Flo API versions are unlikely.

License in practice

MIT license is permissive and imposes no restrictions on use, modification, or distribution in your own projects.

Quickstart

pip install aioflo

import asyncio
from aiohttp import ClientSession
from aioflo import async_get_api

async def main():
    async with ClientSession() as session:
        api = await async_get_api("username", "password", session=session)
        user_info = await api.user.get_info()
        print(user_info)

asyncio.run(main())

Requires Python 3.6 or later. Flo account credentials and an active aiohttp ClientSession are needed to authenticate with the Flo API.

Verify before relying

• Whether the Flo API has changed since the last release in November 2021, potentially breaking compatibility.
• Current status of the Flo Smart Water Detector product line and whether the API remains operational.
• Whether Python 3.11+ is supported despite the latest release predating their introduction.

Package facts

Evidence: aioflo-2021.11.0-py3-none-any.whl

Tags

More WWW/HTTP packages