SmartGuide — a guided device-onboarding assistant for Home Assistant (early version, looking for testers)

Share your Projects! Custom Integrations
1

Hi everyone,

I’ve been building SmartGuide, a small self-hosted tool that sits next to Home Assistant and walks you through connecting a new device step by step: pick category → manufacturer → model, and it checks your actual running instance (MQTT, Zigbee2MQTT, ZHA, Matter, Thread, Hue) instead of asking you to figure that out yourself.

What it does right now:

  • Device lookup against a database of 4,372 real Zigbee devices (from the Zigbee2MQTT/zigbee-herdsman-converters catalog)
  • Live infrastructure detection — reads your HA instance to see what’s actually available, not just what you think is set up
  • Zigbee pairing mode activation (ZHA or Zigbee2MQTT) with real verification — it confirms pairing mode actually turned on instead of just assuming success
  • Automatic detection of newly-paired devices during pairing

What it doesn’t do yet: Matter and Z-Wave are detected but not actively driven the way Zigbee is — that’s next on the list.

It’s a separate Docker container next to your HA setup (embeds nicely into the HA sidebar via a Lovelace iframe if you want), not an integration/add-on.

Install (Docker required):

curl -fsSL https://raw.githubusercontent.com/jenswedem-a11y/home-assistant-integration-assistant/main/install.sh | bash

No manual config file needed — device database loads itself on first start, and you connect your HA instance (URL + long-lived token) directly in the browser afterward.

GitHub: GitHub - jenswedem-a11y/home-assistant-integration-assistant: AI-guided integration assistant for Home Assistant, Zigbee, MQTT and Smart Home devices. · GitHub

Heads up: the UI is currently German-only. English localization isn’t done yet — if that’s a dealbreaker for you today, it’s reasonable to wait, but I wanted to flag it upfront rather than have people find out after installing.

This is an early version and I’d genuinely appreciate people trying it against their own setup — especially non-Linux Docker hosts (Windows/Mac Docker Desktop, Synology, etc.), since so far it’s only been tested on Debian. If something breaks during install or the infrastructure detection gets something wrong for your setup, that’s exactly the kind of feedback I’m looking for.

Happy to answer questions here.