Live monitoring
1 Hz polling streamed to the browser over WebSocket. The dashboard renders itself from the active inverter’s capabilities — PV strings, battery, grid phases, generator, backup load.
SunReye
Self-hosted monitoring, control, and integration for solar / hybrid inverters. An inverter is data, not code.
SunReye polls your inverter over Modbus, stores every reading as time-series data, and gives you a live dashboard, a typed REST API, and an MQTT bridge with Home Assistant auto-discovery — all generated from a single description of the inverter.
What it does
Section titled “What it does”History & analytics
Every sample persisted to TimescaleDB, with per-minute / hourly / daily rollups so multi-week charts stay cheap. Automatic retention cleanup.
Control
Writable settings — charge/discharge currents, work mode, grid charge, solar-sell — exposed as validated controls, guarded by the same validation everywhere.
Costs & tariffs
Turn energy flows into money: import/export tariffs, time-of-use bands, savings vs. grid-only, self-sufficiency and self-consumption.
Integrations
An auto-generated REST API (/api/v1) with OpenAPI docs, plus an MQTT bridge with
Home Assistant MQTT Discovery.
Profiles as data
An inverter ships as a profile — a description of its register map plus semantic metadata. Adding hardware means adding data, not forking the engine.
Start here
Section titled “Start here”Quick StartRun the whole stack against the built-in simulator in five minutes — no hardware.
ArchitectureHow the profile drives the dashboard, the API, and the MQTT topics.
Deploy with DockerBuild and run web + server with Docker Compose.
Author a profileDescribe a new inverter with the typed profile SDK.