Solax
Read energy usage data from the real-time API on Solax solar inverters.
- Real time power, current and voltage
- Grid power information
- Battery level
- Temperature and inverter health
- Daily/Total energy summaries
Usage
pip install solax
Then from within your project:
import solax
import asyncio
async def work():
r = await solax.real_time_api('10.0.0.1')
return await r.get_data()
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
data = loop.run_until_complete(work())
print(data)
This will try all the inverter classes in turn until it finds the first one that works with your installation. You can see the list of inverter implementation classes in the entry points configured in setup.py.
If you want to bypass the inverter discovery code and use a specific inverter class, you can invoke discover specifying directly the class. In this example, the X1 Hybrid Gen4 implementation is used:
from importlib.metadata import entry_points
import solax
import asyncio
INVERTERS_ENTRY_POINTS = {
ep.name: ep.load() for ep in entry_points(group="solax.inverter")
}
async def work():
inverter = await solax.discover("10.0.0.1", 80, "xxxxx", inverters=[INVERTERS_ENTRY_POINTS.get("x1_hybrid_gen4")], return_when=asyncio.FIRST_COMPLETED)
return await inverter.get_data()
loop = asyncio.new_event_loop()
asyncio.set_event_loop(loop)
data = loop.run_until_complete(work())
print(data)
Confirmed Supported Inverters
These inverters have been tested and confirmed to be working. If your inverter is not listed below, this library may still work- please create an issue so we can add your inverter to the list 😊.
- SK-TL5000E
- X1 Hybrid Gen4
You can get the list of supported inverters by looking up the solax.inverter entry points:
for ep in entry_points(group="solax.inverter"):
print(ep)
1 maintainer
Metadata
1 maintainer
Release files for solax 3.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| solax-3.2.4.tar.gz | 33.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| solax-3.2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 65.8 kB
Release files / solax-3.2.4.tar.gz
| Download URL | solax-3.2.4.tar.gz |
|---|---|
| Size | 33.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
eb41480e177ad336967303e7abb3fb5b1b9741cd4c8af58d4dcb63dd3b991779
|
|
BLAKE2b-256 checksum How to use checksums |
89d2768ce989ef0a0e347cab3c68c65f9c039263c2154eeddcb0e42bf77929ff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 3, 2025.
Transparency logRelease files / solax-3.2.4-py3-none-any.whl
| Download URL | solax-3.2.4-py3-none-any.whl |
|---|---|
| Size | 32.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
07d146dcbabb698e78487f63c53acf734a036f117a7d0ab968cd6dd76ae0c3f4
|
|
BLAKE2b-256 checksum How to use checksums |
bb355903683793f2d3a3d2876276787720275962622c2e36442460f7d3a79350
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Dec 3, 2025.
Transparency log
