SMA ennexOS Cloud

Python library for interacting with the SMA ennexOS / Sunny Portal API.

Uses PKCE OAuth2 to authenticate and provides typed access to PV plant data (current power, daily energy, plant info). No browser required.

Installation

pip install sma_ennexos_cloud

Usage

from sma_ennexos_cloud import SmaClient

client = SmaClient(username="your@email.com", password="your-password")
client.login()

plant_name = client.get_plant_name()
power = client.get_current_power()
energy = client.get_daily_energy()

print(f"Plant: {plant_name}")
print(f"Power: {power.value} W")
print(f"Daily energy: {energy.wh} Wh")
client.close()

Checking Live Data Status (Public Statuspage)

You can check whether SMA ennexOS Live Data is operational or under maintenance:

from sma_ennexos_cloud import get_live_data_status

status = get_live_data_status()
print(status)  # "operational" or "under_maintenance"

Or via SmaClient:

client = SmaClient(username="...", password="...", check_portal_status=True)
status = client.get_live_data_status()  # "operational" or "under_maintenance"

API

Method	Returns	Description
`login()`	—	PKCE OAuth2 login
`get_current_power()`	`PowerData`	Live PV power in watts
`get_daily_energy()`	`EnergyData`	Today's total energy in Wh
`get_plant_name()`	`str`	Name of your PV plant
`get_live_data_status(force_refresh=False)`	`str`	Live Data status (`operational`, `under_maintenance`, etc.)
`close()`	—	Close HTTP session

Standalone Functions

Function	Returns	Description
`get_live_data_status(session=None, timeout=10.0)`	`str`	Fetch ennexOS Live Data status without login

Development

pip install -e ".[dev]"
pytest

Metadata

Release files for sma-ennexos-cloud 0.2.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sma-ennexos-cloud 0.2.3
File	Size	Uploaded	Provenance
sma_ennexos_cloud-0.2.3.tar.gz	12.4 kB	Sep 15, 2026	With provenance	Details

Built distribution (wheel)

Table of built distributions (wheels) for sma-ennexos-cloud 0.2.3
File	Interpreter	ABI	Platform	Reset
sma_ennexos_cloud-0.2.3-py3-none-any.whl 10.6 kB Sep 15, 2026 With provenance	Python 3	none	any	Details

Total release size: 23.0 kB

Release files / sma_ennexos_cloud-0.2.3.tar.gz

Download URL	sma_ennexos_cloud-0.2.3.tar.gz
Size	12.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`d83343528e78b47f90f6d456b403732efe90d1c2597e3bd1e4cedeb44aad679b`
BLAKE2b-256 checksum How to use checksums	`85140fd304ce3f2212464610093d8093ed693e136f02923eb40bcb84e29cdaa2`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/MauroDruwel/SMA-ennexOS-cloud
Publishing commit: github.com/MauroDruwel/SMA-ennexOS-cloud/tree/d42af9eaefa3128c575d770d3c55f99777983fab

Workflow

Publishing configuration: github.com/MauroDruwel/SMA-ennexOS-cloud/blob/d42af9eaefa3128c575d770d3c55f99777983fab/.github/workflows/publish.yml
Publishing logs: github.com/MauroDruwel/SMA-ennexOS-cloud/actions/runs/34953895974/attempts/1

Artifact

Subject: sma_ennexos_cloud-0.2.3.tar.gz
SHA-256 checksum: d83343528e78b47f90f6d456b403732efe90d1c2597e3bd1e4cedeb44aad679b Verifying attestations

Release files / sma_ennexos_cloud-0.2.3-py3-none-any.whl

Download URL	sma_ennexos_cloud-0.2.3-py3-none-any.whl
Size	10.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9c627680aa9b0e48468f5384b29f682301b33c8212011eb5b668685c8bb37730`
BLAKE2b-256 checksum How to use checksums	`690ecdbafbd7a2779fadc910305f1299f3c1c70d2dc6dd470ae7cc0ab88ab27a`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/MauroDruwel/SMA-ennexOS-cloud
Publishing commit: github.com/MauroDruwel/SMA-ennexOS-cloud/tree/d42af9eaefa3128c575d770d3c55f99777983fab

Workflow

Publishing configuration: github.com/MauroDruwel/SMA-ennexOS-cloud/blob/d42af9eaefa3128c575d770d3c55f99777983fab/.github/workflows/publish.yml
Publishing logs: github.com/MauroDruwel/SMA-ennexOS-cloud/actions/runs/34953895974/attempts/1

Artifact

Subject: sma_ennexos_cloud-0.2.3-py3-none-any.whl
SHA-256 checksum: 9c627680aa9b0e48468f5384b29f682301b33c8212011eb5b668685c8bb37730 Verifying attestations

Security for sma-ennexos-cloud 0.2.3

Report project as malware

Provenance

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Attestation for sma_ennexos_cloud-0.2.3.tar.gz

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/MauroDruwel/SMA-ennexOS-cloud
Publishing commit: github.com/MauroDruwel/SMA-ennexOS-cloud/tree/d42af9eaefa3128c575d770d3c55f99777983fab

Workflow

Publishing configuration: github.com/MauroDruwel/SMA-ennexOS-cloud/blob/d42af9eaefa3128c575d770d3c55f99777983fab/.github/workflows/publish.yml
Publishing logs: github.com/MauroDruwel/SMA-ennexOS-cloud/actions/runs/34953895974/attempts/1

Artifact

Subject: sma_ennexos_cloud-0.2.3.tar.gz
SHA-256 checksum: d83343528e78b47f90f6d456b403732efe90d1c2597e3bd1e4cedeb44aad679b Verifying attestations

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.