victron-venus
inverter-control↗
Grid-zero feed-in control for Victron inverters. Reads configured Venus D-Bus measurements and applies validated ESS setpoints; dashboards are separate clients.
Open source · Venus OS
Your Victron installation, wired for open control.
Grid-zero feed-in control, battery and PV bridges over D-Bus, live dashboards, solar forecasting, and end-to-end observability — a complete open stack running on Cerbo GX and Venus OS.
power & measurement data & control hover a block to trace its paths
Public project catalog
Venus OS and companion-host tools
Python · Go · Vue · ESPHome
Public source and project documentation
Flagship
Six projects that carry the system
These projects cover control, telemetry, interfaces and development tooling. Deployment and device verification vary by component; see the documented evidence and remaining checks.
dbus-mqtt-battery↗
Bridges JBD BMS batteries published over MQTT onto Venus OS D-Bus, with full DVCC support. No-BMS chains get dbus-virtual-battery.
inverter-dashboard-go↗
Real-time web dashboard as a single Go binary that runs directly on the Cerbo. Same role as inverter-dashboard, zero Docker.
solar-forecast-langgraph↗
LangGraph workflow that forecasts generation from OpenMeteo weather and historical inverter data. Live control requires a separately configured and tested consumer.
mcp-venus-os↗
Companion MCP server for configured Venus OS D-Bus and MQTT access. Write access depends on the enabled tools, permissions and deployed device policy.
venus-os-ci-toolkit↗
Reusable GitHub Actions workflows for adopting projects: lint, test, coverage, govulncheck and Scorecard — pinned by commit SHA.
Wiki
From empty Cerbo to full stack
The docs assume one Cerbo GX, some hardware to sense with, and an afternoon.
01
Install guide
Layer-by-layer setup, from flashing an ESP32 to a running dashboard.
02Architecture
The five layers, what talks D-Bus vs MQTT, and why the split.
03Venus OS integration
D-Bus service names, MQTT topic conventions, PackageManager installs.
04CI standards
Reusable workflows, SHA pinning, releases, version sync rules.
05Contributing
Fork → branch → PR flow, conventional commits, local checks.