Shelly Toolkit for Home Assistant — Gen2+ diagnostics, backup, migration and scripting

Share your Projects!
,
1

Hi everyone,

I’m sharing the first public pre-release of Shelly Toolkit for Home Assistant — an administrator-focused toolkit for diagnostics, maintenance, backup, migration, scripting, and remote RPC access for Shelly Gen2+ devices.

This is an independent community project and is not affiliated with or endorsed by Shelly Group.

What it provides

  • Unified RPC access through local HTTP/WebSocket, the official Home Assistant Shelly integration, and device-initiated remote WebSocket connections

  • Automatic device capability and RPC method discovery

  • Central device inventory with firmware, connection, uptime, temperature, Wi-Fi and RPC information when available

  • Shelly Doctor diagnostics with Home Assistant Repairs

  • Secret-redacted device backups and compatibility-aware restore previews

  • Exact Clone and capability-based Smart Migration

  • RPC Explorer with local method history and JSON responses

  • Shelly Script download, upload, start, stop, restart and status

  • Automatic backup before overwriting an existing script

  • RPC event history and Home Assistant event forwarding

  • Response-enabled Home Assistant actions for automations

  • Responsive, dependency-free administrator panel

The Toolkit can reuse devices already loaded by Home Assistant’s official Shelly integration without taking over or duplicating its normal entities.

It is not intended to replace the official Shelly integration or act as a cloud service.

Requirements

  • Home Assistant 2026.8 or newer

  • Home Assistant administrator account

  • Shelly Gen2+ device for direct RPC targets

  • HTTPS/WSS when using Remote Pair over an untrusted network

Installation through HACS

The project has not yet been added to the default HACS repository list, so it must currently be installed as a custom repository:

  1. Open HACS.

  2. Select Custom repositories.

  3. Add:

    https://github.com/drHouse-gif/shelly-rpc-bridge

  4. Select category Integration.

  5. Open Shelly Toolkit for Home Assistant and download it.

  6. Restart Home Assistant.

  7. Go to Settings → Devices & services → Add integration.

  8. Add Shelly Toolkit for Home Assistant.

  9. Open Shelly Toolkit from the sidebar.

Current status

Version v0.4.1 is an experimental pre-release intended for careful testing on non-critical devices.

The integration passes its automated Python, Home Assistant, HACS, hassfest, lint, formatting, type-checking and frontend validation. The previous v0.4.0 build was also tested successfully with physical Shelly hardware.

Please keep a backup and carefully review every restore, migration, script upload or mutating RPC call before executing it.

Backups may contain Shelly Script source code. Please do not publish backups, diagnostics, credentials, tokens or unredacted logs.

Feedback wanted

Testing on different Gen2+ models and firmware versions would be very helpful. When reporting an issue, please include:

  • Shelly model and firmware version

  • Home Assistant version

  • Connection type used

  • Steps to reproduce

  • Redacted logs or diagnostics

  • Whether the official Shelly integration is also loaded

GitHub repository:

v0.4.1 release:

Thanks to everyone willing to test it and provide feedback.

2

This is something I’m really looking forward to. I have a huge number of automations, scripts, Shelly relays etc.

However, due to “experimental pre-release intended for careful testing on non-critical devices.” - I have to force myself to wait!..