Skip to content
View 4alvit's full-sized avatar

Block or report 4alvit

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
4alvit/README.md

Hi there! I'm a Software Engineer & IoT Architect 👋

I specialize in building robust, low-latency control systems and monitoring stacks for renewable energy and home automation. My work focuses on the Victron Energy ecosystem, where I've developed a comprehensive suite of tools to bridge the gap between industrial energy hardware and modern web/embedded technologies.

🚀 Key Expertise

  • Systems Programming: Real-time control loops in Python and high-performance services in Go and Rust.
  • Embedded & IoT: Custom firmware development with ESPHome, Bluetooth (BLE) proxying, and MQTT-based messaging.
  • Energy Management: Advanced ESS (Energy Storage System) logic, split-phase compensation, and grid-zero targeting.
  • Full-Stack Monitoring: Real-time dashboards (FastAPI, Vue.js, Tauri) and time-series observability (TIG stack).
  • Infrastructure as Code: Managing complex GitHub organizations and repository configurations via Terraform.

🏗️ System Architecture

My project suite forms a complete ecosystem for home energy management:

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

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

    subgraph Hardware["Hardware Layer"]
        direction LR
        BMS[JBD BMS / LiFePO4] -- BLE --- ESP[ESP32 / ESPHome]
        TP[Tasmota Plug] -- HTTP --- PV[PV Inverter]
        VIC[Victron MultiPlus/Cerbo]
    end

    subgraph Control["Control Layer (Venus OS)"]
        direction LR
        ESP -- MQTT --- BM[dbus-mqtt-battery]
        TP -- HTTP --- TV[dbus-tasmota-pv]
        BM -- D-Bus --- VIC
        TV -- D-Bus --- VIC
        IC[inverter-control] -- D-Bus --- VIC
        EL[dbus-event-log] -- D-Bus monitor --- VIC
        GOV[venus-os-governance] -- Policy engine --- VIC
        OBS[venus-os-observability] -- OTel tracing --- VIC
    end

    subgraph UI["Monitoring & UI"]
        direction LR
        IC -- MQTT --- MQTT
        MQTT --> DGO[inverter-dashboard-go]
        MQTT --> DPY[inverter-dashboard]
        MQTT --> DVUE[inverter-dashboard-vue]
        MQTT --> DT[inverter-desktop]
        MQTT --> MON[inverter-monitoring]
        MQTT --> MCP[mcp-venus-os]
    end

    %% Invisible edges to force vertical stack order
    Data -.-> Bridge
    Bridge -.-> Hardware
    Hardware -.-> Control
    Control -.-> UI
Loading

Dev & Ops

Repository Role
integration-tests MQTT / battery / PV integration test harness
terraform-github-victron Terraform IaC for victron-venus org
terraform-github-4alvit Terraform IaC for personal 4alvit account
iot-project-builder-profile Auto engineering profile generator from GitHub activity

🔋 Featured Projects

Advanced ESS Grid-Zero Controller

  • Developed a high-frequency (3Hz) control loop to maintain zero grid feed-in for split-phase systems.
  • Implemented complex logic for EV charger exclusion, battery protection, and multi-mode energy strategies.
  • Tech: Python, D-Bus, Home Assistant API, MQTT.

Real-time Energy Observability

  • Built high-performance monitoring interfaces with WebSocket-based live updates.
  • The Go version provides a single-binary deployment with sub-10ms latency and minimal memory footprint.
  • Tech: Go, FastAPI, Vue.js, WebSockets, Docker.

Cross-Platform Monitoring Suite

  • Developed a native desktop application using Tauri and Rust for low-resource system monitoring.
  • Implemented secure MQTT communication with built-in security auditing and fuzz testing (OSS-Fuzz).
  • Tech: Rust, Tauri, TypeScript, Vite.

Embedded Battery Management Bridge

  • Created a robust BLE-to-MQTT proxy to offload unstable Bluetooth connections from the main controller.
  • Developed the D-Bus bridge that dynamically registers multiple battery chains as native Victron devices.
  • Tech: C++ (ESPHome), Python, BLE, MQTT.

System Observability & Time-Series Data

  • Deployed a comprehensive TIG (Telegraf, InfluxDB, Grafana) stack for long-term telemetry storage and visualization.
  • Implemented automated log shipping with Loki and GitHub webhook-based auto-deployment for the monitoring infrastructure.
  • Tech: Docker, Telegraf, InfluxDB, Grafana, Loki.

Policy Engine with Approval Gates

  • Policy engine for Venus OS with SOC limits, charge/discharge rules, inverter control policies.
  • Audit logging via dbus-event-log with approval workflows for critical operations.
  • Tech: Python, D-Bus, MQTT, Policy-as-Code.

OpenTelemetry/Prometheus Observability Stack

  • D-Bus event tracing, inverter metrics export, distributed tracing across MQTT → D-Bus → inverter-control pipeline.
  • Tech: OpenTelemetry, Prometheus, Grafana, D-Bus.

RAG Pipeline for Victron Knowledge

  • Retrieval-Augmented Generation for Victron Energy documentation and community knowledge.
  • Built with FastAPI, LangChain, pgvector, and PostgreSQL.
  • Tech: Python, FastAPI, LangChain, pgvector, PostgreSQL.

Solar Forecasting with LangGraph

  • Advanced solar forecasting using LangGraph for multi-step reasoning and tool use.
  • Tech: Python, LangGraph, LangChain, FastAPI.

Automated Engineering Profile Generator

  • Analyzes GitHub repositories, ESPHome configurations, and D-Bus services to generate comprehensive engineering profiles.
  • Tech: Python, GitHub API, GraphQL, Jinja2.

MCP Server for Venus OS Management

  • Model Context Protocol server for reading and controlling Venus OS devices via D-Bus and MQTT.
  • Tech: Python, MCP, D-Bus, MQTT.

Production-Ready REST/WebSocket → MQTT Bridge

  • Authentication, rate limiting, and real-time streaming capabilities.
  • Tech: FastAPI, MQTT, WebSockets, JWT.

Complete Observability Stack for MQTT IoT Systems

  • Tech: OpenTelemetry, Prometheus, Grafana, MQTT.

Audit Log for D-Bus Commands & State Transitions

  • Captures all D-Bus signals, method calls, and service lifecycle events on Victron Energy systems.
  • Critical for post-mortem analysis of incidents (overloads, battery failures, communication issues).
  • Tech: Python, D-Bus, SQLite/TimescaleDB, MQTT.

Copier Template for New D-Bus Services

  • Template for generating new D-Bus services with best practices.
  • Tech: Python, Copier, D-Bus.

Reference Library of Production-Ready ESPHome Configurations

  • Extracted from real deployments monitoring 8+ JBD BMS units, Daly BMS, and various temperature/plant sensors.
  • Tech: ESPHome, C++, YAML, BLE.

MQTT / Battery / PV Integration Test Harness

  • Tech: Python, pytest, MQTT, D-Bus simulation.

Infrastructure as Code for victron-venus Organization

  • Manages the entire victron-venus organization, including 20+ repositories, branch protections, and CI/CD secrets.
  • Tech: Terraform, GitHub Actions, HCL.

🛠️ Technical Stack

Languages & Frameworks

Python Go Rust TypeScript Vue.js

IoT & Infrastructure

MQTT Docker Terraform GitHub Actions Home Assistant


📫 Let's Connect

Pinned Loading

  1. victron-venus/dbus-tasmota-pv victron-venus/dbus-tasmota-pv Public

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

    Python 1

  2. victron-venus/esphome-jbd-bms-mqtt victron-venus/esphome-jbd-bms-mqtt Public

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

    YAML 1 1

  3. victron-venus/inverter-control victron-venus/inverter-control Public

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

    Python 1

  4. terraform-github-victron terraform-github-victron Public

    Terraform IaC for victron-venus GitHub organization infrastructure

    HCL

  5. victron-venus/dbus-mqtt-battery victron-venus/dbus-mqtt-battery Public

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

    Python 1

  6. victron-venus/inverter-dashboard victron-venus/inverter-dashboard Public

    Real-time web dashboard for Victron inverter monitoring via MQTT

    Python 1