p1monitor

What it is and what it does

p1monitor is an async Python client for querying P1 Monitor devices—hardware that reads the P1 serial port of smart meters. It wraps the P1 Monitor's HTTP API to fetch real-time meter data: smart meter readings (gas, power consumption/production, tariff info), three-phase voltage and current, and water meter consumption. The library uses aiohttp for non-blocking HTTP requests, making it suitable for integration into async applications like Home Assistant or other home automation platforms.

You instantiate a P1Monitor client with the device's IP and port, then call async methods (smartmeter(), watermeter(), settings(), phases()) to retrieve structured meter data. The library is actively maintained, supports Python 3.11–3.13, and carries no known vulnerabilities.

Use it for:

• Integrate real-time energy consumption data into Home Assistant or other home automation systems.
• Build a dashboard that displays current power draw, gas usage, and tariff information from your smart meter.
• Monitor three-phase voltage and current across your home's electrical installation.
• Track daily and total water consumption when your P1 Monitor supports the water meter API.
• Collect meter readings for billing or energy analysis scripts running on a home server.

Worth the install?

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

Asynchronous Python client library for reading smart meter and water meter data from P1 Monitor devices via their API.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is licensed permissively under MIT. Install it if you own a P1 Monitor device and need to read its data from Python—particularly for home automation or energy monitoring. The async design and modern Python support make it a straightforward choice for this use case.

Install

p1monitor on PyPI

pip install p1monitor

uv add p1monitor

poetry add p1monitor

Installing p1monitor

Before you install

Low install friction with only two runtime dependencies (aiohttp and yarl). The package is actively maintained with recent commits and supports modern Python versions (3.11+).

License in practice

MIT license is permissive; you can use, modify, and distribute this package freely with minimal restrictions, provided you include the license notice.

Quickstart

pip install p1monitor

import asyncio
from p1monitor import P1Monitor

async def main():
    async with P1Monitor(host="192.168.1.2", port=80) as client:
        smartmeter = await client.smartmeter()
        print(smartmeter)

asyncio.run(main())

Requires Python 3.11 or higher; P1 Monitor device must be accessible at the specified host and port.

Verify before relying

• Whether the package handles authentication or if the P1 Monitor API requires credentials.
• Timeout behavior and retry logic when the P1 Monitor device is unreachable.
• Whether watermeter() and phases() methods are available in all P1 Monitor firmware versions.

Package facts

Evidence: p1monitor-3.2.0-py3-none-any.whl

Keywords: p1, monitor, power, energy, api, async, client

Tags

More Python Modules packages