---
id: p1monitor
version: "3.2.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# p1monitor — Asynchronous Python client for the P1 Monitor

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

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

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

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

## Tags

p1 monitor api client, smart meter data async, energy consumption monitoring, p1 port reader python, home automation meter data, asyncio smart meter, power consumption api, smart-meter, home-automation, async-client

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