gitwtfhub

wtf is huawei-fusion-hub?

naked-head/huawei-fusion-hub — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · generalComplexity · 2/5LicenseSetup · moderate

TL;DR

A Home Assistant add-on that combines multiple Huawei solar integrations into one reliable set of sensors, automatically switching to whichever source is currently working.

Mindmap

mindmap
  root((huawei-fusion-hub))
    What it does
      Combines solar data sources
      Priority based failover
      Unit normalization
    Tech stack
      Home Assistant
      Python
      HACS
    Use cases
      Reliable solar dashboards
      Source outage alerts
      Energy history migration
    Audience
      Home Assistant users
      Solar system owners
    Setup
      Install via HACS
      Needs source integration

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Keep solar power dashboards and automations working even when the local inverter connection drops out.

REASON 2

Combine data from up to three separate Huawei solar integrations into one consistent set of sensors.

REASON 3

Get notified automatically when a solar data source goes offline or comes back online.

REASON 4

Migrate historical Energy Dashboard statistics from an old integration to the new combined sensors.

What's in the stack?

PythonHome AssistantHACS

How it stacks up

naked-head/huawei-fusion-hub0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audiencegeneralgeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires at least one existing Huawei solar integration already installed and configured in Home Assistant.

Licensed under GPL v3, which allows free use and modification but requires derivative works to also be shared under GPL v3.

Wtf does this do

Huawei Fusion Hub is a custom integration for Home Assistant, the popular open source home automation platform. It is meant for people who own a Huawei solar power system and already use one or more existing Home Assistant integrations to read data from it, such as Huawei Solar, FusionSolar, or FusionSolarPlus. The problem it solves is that each of those existing integrations reads from a different source. The local connection is fast and accurate but sometimes drops out, while the cloud based sources are more reliable but slower. Fusion Hub sits in front of all three, watches which ones are currently available, and always shows the best value it can find, following a priority order the user sets. It does not talk to the inverter or the cloud itself, it simply reads whatever data those other integrations already publish inside Home Assistant. Once set up, it creates a stable set of 221 sensors, grouped into devices like Inverter, Battery, Power Meter, and Plant, so dashboards and automations keep working no matter which underlying source is currently active. Every sensor also shows which source it is currently pulling from. Values from different sources are automatically converted into matching units, so numbers stay consistent even if one integration reports in kilowatts and another in watts. The hub can also detect when a new source integration gets installed or re-enabled and automatically add its entities without needing a restart, and it can send a notification if a source goes offline or comes back online. There is an optional, off by default feature to also proxy control entities like switches through the hub. Installation is done through HACS or by copying files manually into the Home Assistant custom_components folder, and the interface is available in English and Italian. The project is unofficial and not affiliated with Huawei.

Yoink these prompts

Prompt 1
Help me install Huawei Fusion Hub in Home Assistant using HACS and connect it to my existing Huawei Solar integration.
Prompt 2
Explain how the priority based failover in Huawei Fusion Hub decides which data source to use for a sensor.
Prompt 3
Walk me through migrating my Energy Dashboard history to Huawei Fusion Hub using the ENERGY_MIGRATION.md guide.
Prompt 4
Help me set up disconnect notifications so I know when one of my solar data sources goes offline.
Prompt 5
Explain the difference between the Huawei Solar, FusionSolar, and FusionSolarPlus integrations that Fusion Hub aggregates.

Frequently asked questions

wtf is huawei-fusion-hub?

A Home Assistant add-on that combines multiple Huawei solar integrations into one reliable set of sensors, automatically switching to whichever source is currently working.

What language is huawei-fusion-hub written in?

Mainly Python. The stack also includes Python, Home Assistant, HACS.

What license does huawei-fusion-hub use?

Licensed under GPL v3, which allows free use and modification but requires derivative works to also be shared under GPL v3.

How hard is huawei-fusion-hub to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is huawei-fusion-hub for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.