pyenphase

What it is and what it does

Pyenphase is a Python library for interacting with Enphase Envoy solar energy systems. It abstracts the HTTP communication layer needed to query and control Envoy devices, handling authentication, request formatting, and response parsing so you don't have to build that plumbing yourself. The library uses aiohttp for asynchronous network I/O, making it suitable for integration into async Python applications like home automation systems or monitoring dashboards.

The package depends on seven runtime libraries: aiohttp for HTTP requests, awesomeversion for version comparisons, envoy-utils for Envoy-specific utilities, lxml for XML parsing, orjson for fast JSON handling, pyjwt for JWT token operations, and tenacity for retry logic. It's actively maintained, supports modern Python versions from 3.10 to 3.14, and carries an MIT license with no known security vulnerabilities.

Use it for:

• Integrate Enphase Envoy monitoring into a home automation system to track real-time solar production data.
• Build a custom dashboard or web service that queries multiple Envoy devices and aggregates their metrics.
• Automate energy management tasks by reading Envoy state and triggering actions based on production thresholds.
• Develop a monitoring bot that periodically fetches Envoy data and logs it to a time-series database.

Worth the install?

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

Provides a Python library to communicate with and control Enphase Envoy solar energy systems over the network.

Yes. The library is actively maintained, has low install friction, carries a permissive MIT license, and addresses a specific need for Enphase Envoy integration in Python. It's suitable for home automation, monitoring, and energy management projects. No known security issues.

Install

pyenphase on PyPI

pip install pyenphase

uv add pyenphase

poetry add pyenphase

Installing pyenphase

Before you install

Low install friction with a pure-Python wheel distribution. Active maintenance with a release 9 days ago and recent commits; supports Python 3.10 through 3.14.

License in practice

MIT license permits commercial and private use, modification, and distribution with minimal restrictions—suitable for integration into most projects.

Quickstart

pip install pyenphase

import aiohttp
from pyenphase import Envoy

async with aiohttp.ClientSession() as session:
    envoy = Envoy(session, host="envoy_device")
    data = await envoy.fetch_data()

Requires Python 3.10 or later; Envoy device must be reachable on the network and credentials may be required depending on device configuration.

Verify before relying

• Whether the library supports all Envoy hardware models and firmware versions currently in the field.
• Authentication requirements and whether credentials must be pre-configured or obtained through the package.
• Scope of control operations available (read-only monitoring vs. write operations like power adjustments).
• Specific network configuration or IP address format requirements for connecting to Envoy devices.

Package facts

Evidence: pyenphase-3.2.1-py3-none-any.whl

Tags

More Libraries packages