HA Bridge Plugin Guide

seenzus Bridge is the plugin that runs inside Home Assistant and connects your space to seenzus, both ways:

• No tunneling required: the bridge dials out over public MQTT; your HA exposes no ports;
• Per-bridge credentials: every bridge gets its own connection credentials and can only send/receive on its own lane;
• Three-channel protocol: commands, results and state flow separately, with device state reported as an event stream — what you see in the app is what’s happening at home.

Download opening soon

The plugin is in a final refactoring pass — the download will open on this page shortly. The integration currently shows the legacy name “SavantAI MQTT Bridge”; the rename is in progress, and the protocol and pairing flow are unchanged.

Install

Download the plugin package, unzip it into Home Assistant’s config/custom_components/ directory, and restart HA. You’ll then find it under Settings → Devices & Services → Add Integration.

Pairing mode 1: Quick pair (recommended)

1. When adding the integration, choose Quick pair and enter the seenzus service address;
2. Your browser opens the authorization page — log in and confirm;
3. Back in HA, the integration completes automatically: the bridge receives its own credentials and starts reporting the device catalog.

You never type a single MQTT parameter.

Pairing mode 2: Manual MQTT (bring your own broker)

Prefer your own MQTT broker? Choose manual mode: fill in broker host, port, username, password and bridgeId, then pick “Manual” on the app’s Sources page with the same parameters. It’s the escape hatch for power users — most people should quick-pair.

After pairing

• A card for the bridge appears on the Sources page, with live status and coverage (N devices · M spaces);
• Devices get sorted into Spaces — rename and rearrange them in the app; seenzus follows your naming;
• Renaming, broker changes and disabling all live on the source card: disabling cuts the connection but keeps your data.

Troubleshooting

Symptom	Check this first
Authorization page won’t open	Verify the service address is complete (including scheme); try another browser
”Pairing session expired”	Sessions are one-shot — start a fresh quick-pair from HA
Paired but no devices	Give it a moment (catalog sync takes a beat); confirm the source card shows “online”
Source shows offline	Is the plugin running in HA? The bridge reconnects automatically after outages/restarts
Device state frozen	Bridge online but stale? Hit “Test connection” on the source card

Still stuck? See the FAQ or come find us.