[Custom Integration] Upgrade Advisor — Know what'll break before you hit update

Share your Projects! Custom Integrations
, ,
1

Upgrade Advisor icon
Upgrade Advisor icon512×512 9.23 KB

We’ve all been there. A new Home Assistant update drops, you hit that update button, and suddenly half your automations are broken and your YAML is throwing errors. You scroll through the release notes after the fact thinking, “I really should have read these first.”

I built Upgrade Advisor to solve exactly that problem. It reads the release notes for you, checks them against your actual setup, and tells you what’s going to break — before you update.

What it does

When a Home Assistant update becomes available, Upgrade Advisor kicks in automatically. It works in two phases:

  1. AI analysis — It sends the release notes to your configured AI agent (OpenAI, Google Generative AI, Anthropic, Ollama, etc.) along with context about your installation. The AI identifies which breaking changes could potentially affect you and outputs specific checks to run.

  2. Automated verification — This is the part I’m most proud of. Rather than just giving you AI speculation, the integration actually verifies the concerns. It searches your YAML config files, checks entity availability, audits your automations, and scans your Lovelace dashboards. Then it summarizes everything into a factual report with evidence.

The key difference: it tells you what IS affected, not what MIGHT be. You get a risk assessment (Low / Medium / High) backed by actual findings from your config.

It also works with HACS component updates, not just HA core.

What you get

  • A sensor.upgrade_advisor entity with a full markdown report in its attributes
  • Automatic repair issues created for confirmed breaking changes
  • An event entity that fires when analysis completes (handy for notification automations)
  • A service call (upgrade_advisor.analyze) you can trigger manually whenever you want

Just throw a Markdown card on your dashboard with {{ state_attr('sensor.upgrade_advisor', 'report') }} and you’ve got a nice upgrade report right on your main screen.

Installation

Available through HACS as a custom repository:

  1. Open HACS → three-dot menu → Custom repositories
  2. Add https://github.com/brianegge/ha-upgrade-advisor as an Integration
  3. Download it, restart HA
  4. Go to Settings → Devices & Services → Add Integration → Upgrade Advisor
  5. Pick your AI conversation agent from the dropdown — done!

Requirements: Home Assistant 2024.7.0+ and any configured AI conversation agent.

Links

:house: GitHub: GitHub - brianegge/ha-upgrade-advisor: AI-powered upgrade analysis for Home Assistant — HACS custom integration · GitHub

I’d love to hear your feedback, feature requests, or bug reports. This has saved me from a few rough upgrades already, and I hope it helps you too!

4 Likes
2

When I try to add the integration, The config flow looks like this and CPU ramps up (on PC accessing the frontend, not the HA Host) and not able to install, nothing in logs

image
image786×133 5.83 KB

3

Thanks for reporting this! The issue is in manifest.json — the conversation integration was listed as an after_dependency instead of a dependency. This means the conversation frontend components aren’t guaranteed to be loaded when the config flow renders the agent picker, which causes the browser to spin.

Fix is in this commit: changed after_dependencies to dependencies in manifest.json. Can you try updating and see if that resolves it?

If it still happens, could you check your browser dev console (F12 → Console) for any JavaScript errors while the config flow is open? That would help narrow it down further.

4

Hi, tried that version but just the same.

Lots of errors while the box is open (1000s) this is a screengrab of what looks like repeating:

image
image2376×1762 285 KB

5

Please try again with v1.0.3

image
image606×369 19.8 KB

6

Yes the config flow works now.

Entities are showing as unknown, apart from Status that is showing as idle, is that correct ?

image
image761×761 37.5 KB

I get this in the log when running the action:

Log details (WARNING)
This error originated from a custom integration.
Logger: custom_components.upgrade_advisor
Source: custom_components/upgrade_advisor/__init__.py:149
integration: Upgrade Advisor (documentation, issues)
First occurred: 8:02:22 am (2 occurrences)
Last logged: 8:03:26 am

No updates available to analyze
7

Hi again, thanks for your patience. I think this is normal if you don’t have any pending updates. You should see something next time HA updates or a HACS integration. Add on updates don’t appear (and I can’t think of a way this integration would help).

8

A new HA upgrade just released. You should see an upgrade advisor notice now. And it should be different than my notice :smile:

image
image1206×1523 132 KB