growattServer

What it is and what it does

Growatt Server is a Python client library for querying Growatt photovoltaic inverter systems. It abstracts the Growatt API into a usable interface, supporting both the legacy password-based authentication method and the newer official V1 token-based API. The library depends only on requests for HTTP communication.

The package is designed for reading PV system data—status, performance metrics, and configuration—from Growatt servers. It also exposes configuration modification functions, though the maintainers emphasize that only settings functions alter system state; all other operations are read-only. The library is actively maintained and includes examples for both API variants, with V1 API recommended for new projects due to better security and relaxed rate limits.

Use it for:

• Monitor solar inverter performance and energy production in real-time dashboards or home automation systems.
• Retrieve historical PV data for analysis, reporting, or integration with energy management platforms.
• Automate configuration changes to Growatt inverters programmatically (with caution, as settings can affect system operation).
• Build custom alerting systems that check inverter status and notify on faults or performance anomalies.
• Integrate Growatt data into smart home ecosystems or IoT platforms that aggregate multiple energy sources.

Worth the install?

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

Retrieves photovoltaic system information from Growatt inverter servers using either the legacy password-based API or the official token-based V1 API.

Yes, if you own or manage Growatt inverters and need programmatic access to their data. The package is actively maintained, has low install friction, uses a permissive license, and carries no known vulnerabilities. The main caveat is that configuration modification functions carry real operational risk—use only if you understand the consequences—and V1 API support is currently limited to MIN and SPH device types.

Install

growattserver on PyPI

pip install growattserver

uv add growattserver

poetry add growattserver

Installing growattServer

Before you install

Low install friction with a single runtime dependency (requests). Active maintenance with a recent release (68 days ago) and ongoing repository activity.

License in practice

MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute this package freely provided you include the license notice.

Quickstart

pip install growattServer

from growattServer.api import GrowattApi
api = GrowattApi()
# Login and retrieve data using either legacy or V1 API

Requires valid Growatt account credentials and network access to Growatt servers; V1 API supports MIN and SPH devices specifically.

Verify before relying

• Whether the package works with all Growatt inverter models or only those explicitly listed (MIN, SPH, classic TLX, classic MIX).
• Specific Python version compatibility (requires_python is unspecified in metadata).
• Rate limiting behavior and recommended polling intervals for production use.

Package facts

Evidence: growattserver-2.2.0-py3-none-any.whl

Tags

More Monitoring packages