Skip to content
@victron-venus

victron-venus

Victron Venus

Open-source tools for Victron Energy systems on Venus OS — grid-zero control, battery/PV bridges, dashboards, and observability.

Created by @4alvit.

System architecture

flowchart TB
    subgraph Hardware["Hardware layer"]
        BMS["JBD BMS / LiFePO4"]
        ESP["ESP32 + ESPHome"]
        TAS["Tasmota energy meter"]
        CERBO["Cerbo GX / Venus OS"]
    end

    subgraph Control["Control layer (Venus OS packages)"]
        ESP -->|"BLE → MQTT"| BM["dbus-mqtt-battery"]
        TAS -->|"HTTP"| PV["dbus-tasmota-pv"]
        BM -->|"D-Bus"| CERBO
        PV -->|"D-Bus"| CERBO
        IC["inverter-control"] -->|"D-Bus"| CERBO
        EL["dbus-event-log"] -->|"D-Bus monitor"| CERBO
        GOV["venus-os-governance"] -->|"Policy engine"| CERBO
        OBS["venus-os-observability"] -->|"OTel tracing"| CERBO
    end

    subgraph Bridge["Bridge services"]
        ESP -.->|"BLE → MQTT"| ESPH["esphome-jbd-bms-mqtt"]
        ESPH -.-> BM
        FG["fastapi-mqtt-gateway"] -.->|"REST/WS → MQTT"| MQTT["MQTT broker"]
        MO["mqtt-observability-opentelemetry"] -.->|"OTel → metrics/traces"| MQTT
    end

    subgraph UI["Monitoring & dashboards"]
        IC -->|"MQTT inverter/state"| MQTT
        MQTT --> DGO["inverter-dashboard-go\n(primary Cerbo binary)"]
        MQTT --> DPY["inverter-dashboard\n(Docker / alvit/inverter-dashboard)"]
        MQTT --> DVUE["inverter-dashboard-vue\n(shared Vue components)"]
        MQTT --> DT["inverter-desktop\n(Tauri client)"]
        MQTT --> MON["inverter-monitoring\n(TIG stack)"]
        MQTT --> MCP["mcp-venus-os\n(MCP server)"]
    end

    subgraph Data["Data & analytics"]
        RAG["energy-data-rag-pipeline"] -->|"RAG pipeline"| DOCS["Victron docs + community"]
        SF["solar-forecast-langgraph"] -->|"Forecast + LangGraph"| MQTT
    end

    subgraph Dev["Development & ops"]
        IT["integration-tests"]
        TFV["terraform-github-victron"]
        TF4["terraform-github-4alvit (personal)"]
        BUILD["iot-project-builder-profile"]
    end

    style IC fill:#4ecdc4,color:#000
    style DGO fill:#00ADD8,color:#fff
    style DPY fill:#3776ab,color:#fff
    style DT fill:#24c8db,color:#000
    style GOV fill:#e74c3c,color:#fff
    style OBS fill:#8e44ad,color:#fff
Loading

ESP32 setup: Flash esphome-jbd-bms-mqtt separately (not via Venus PackageManager). See INSTALL.md.

Repositories

Core control & bridging

Repository Role
inverter-control Grid-zero ESS external control (3 Hz loop, Home Assistant)
dbus-mqtt-battery MQTT → D-Bus bridge for JBD BMS batteries (DVCC)
dbus-tasmota-pv Tasmota power meter → D-Bus PV inverter
dbus-event-log Audit log of D-Bus commands & state transitions
dbus-service-template Copier template for new D-Bus services
esphome-jbd-bms-mqtt ESP32 BLE proxy for JBD BMS → MQTT
esphome-ble-sensor-patterns Production-ready ESPHome BLE sensor configurations

Dashboards & UI

Repository Role
inverter-dashboard-go Primary Cerbo dashboard — single Go binary
inverter-dashboard Python/FastAPI dashboard — Docker alvit/inverter-dashboard
inverter-dashboard-vue Shared Vue 3 SPA component library
inverter-desktop Native Tauri desktop/mobile client
inverter-monitoring Telegraf + InfluxDB + Grafana stack

Platform services

Repository Role
fastapi-mqtt-gateway REST/WebSocket → MQTT bridge (auth, rate limiting, streaming)
mqtt-observability-opentelemetry OpenTelemetry observability for MQTT IoT systems
venus-os-observability OTel/Prometheus for Venus OS — D-Bus tracing, metrics export
venus-os-governance Policy engine with approval gates — SOC limits, charge/discharge rules
mcp-venus-os MCP server for Venus OS D-Bus/MQTT management

Data & AI

Repository Role
energy-data-rag-pipeline RAG pipeline for Victron docs + community knowledge (FastAPI, LangChain, pgvector)
solar-forecast-langgraph Solar forecasting with LangGraph (personal account)
iot-project-builder-profile Automated engineering profile generator from GitHub activity

Testing & infrastructure

Repository Role
integration-tests MQTT / battery / PV integration test harness
terraform-github-victron Terraform for org repos, branch rules, and policies
.github Organization profile and shared docs (this repo)

Dashboard choice

Use case Recommended repo
Cerbo GX, minimal resources inverter-dashboard-go
NAS / Docker / Portainer inverter-dashboard (alvit/inverter-dashboard)
Desktop or mobile app inverter-desktop
Long-term metrics & Grafana inverter-monitoring
Custom Vue dashboard inverter-dashboard-vue

Getting started

Full stack install guide: docs/INSTALL.md

Quick Cerbo bootstrap (Venus packages only):

git clone https://github.com/victron-venus/inverter-control.git  # or use bootstrap.sh from a local checkout
# See inverter-control README for SetupHelper / PackageManager install

Community

  • Issues: open in the relevant project repository
  • Discussions: enable at org level (Settings → General → Discussions) or per-repo via Terraform has_discussions = true
  • Contributing: CONTRIBUTING.md

License

Most projects use the MIT License. See each repository for details.


Community project — not affiliated with Victron Energy.

Pinned Loading

  1. esphome-jbd-bms-mqtt esphome-jbd-bms-mqtt Public

    ESPHome ESP32 Bluetooth proxy for JBD BMS batteries, publishing to MQTT for Victron Venus OS

    YAML 1 1

  2. dbus-mqtt-battery dbus-mqtt-battery Public

    MQTT to D-Bus bridge for JBD BMS batteries on Victron Venus OS with DVCC support

    Python 1

  3. dbus-tasmota-pv dbus-tasmota-pv Public

    Tasmota power meter to Victron D-Bus PV inverter bridge for Venus OS

    Python 1

  4. inverter-control inverter-control Public

    Grid-zero feed-in control for Victron inverters with Home Assistant integration and web dashboard

    Python 1

  5. inverter-dashboard inverter-dashboard Public

    Real-time web dashboard for Victron inverter monitoring via MQTT

    Python 1

  6. inverter-monitoring inverter-monitoring Public

    Telegraf + InfluxDB + Grafana monitoring stack for Victron inverter systems

    Python 1

Repositories

Showing 10 of 15 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…