A command-line tool for monitoring and exporting data from GivEnergy inverters over the local network, built on givenergy-modbus.

• Python 3.13+
• A GivEnergy inverter accessible on the local network

uv sync

After uv sync the givenergy-cli command is available at .venv/bin/givenergy-cli, or via uv run givenergy-cli.

host and port are shared options on the root command. They can also be supplied via the GIVENERGY_HOST / GIVENERGY_PORT environment variables.

uv run givenergy-cli --host 192.168.x.x tui

Live Inverter / Power Flow / Battery panels, a modbus log panel, and a status bar showing connection state and the time of the last refresh. The Inverter panel has collapsible Charge Slot and Discharge Slot sections.

uv run givenergy-cli --host 192.168.x.x export -o plant.json

Connects, does a full refresh with max_batteries=5, and writes every register from every discovered slave address. Partial captures are still written on timeout, with a warning.

uv run givenergy-cli inspect plant.json

Reconstructs the Plant from the JSON, then prints the Inverter and Battery model fields plus per-slave raw register dumps (decimal + hex). No network required.

givenergy_cli/
    __init__.py
    __main__.py    — Typer entry point (tui / export / inspect subcommands)
    app.py         — Textual TUI app
    registers.py   — export, load, and rich-formatted display of register dumps
tests/
    fixtures/      — anonymised plant JSON fixtures (good + bad-enum cases)