---
id: pyenphase
version: "3.2.1"
license: MIT
license_treatment: permissive
maintenance: active
---

# pyenphase — Library to control enphase envoy

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

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

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

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

## Tags

enphase envoy control library, solar inverter api python, envoy device communication, enphase system monitoring, solar energy device integration, solar-energy, home-automation, async-io

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