BETA — Open to testers. Tell us what to fix on @vomehome or via a tester code.

Tuya Local Bridge

An open-source Home Assistant add-on we wrote and gave away — it finds your Tuya devices' local keys without a developer account and moves them to local control.

Updated 12 September 2026 tuyahome-assistantlocal-controlopen-source

Tuya Local Bridge is a Home Assistant add-on that finds the local keys for your Tuya devices and moves them onto local control, without a Tuya developer account and without breaking the automations you already have.

It is free, MIT-licensed and lives on GitHub. It needs no Vome account, no Vome server, and no connection to us — it runs entirely inside your own Home Assistant. We wrote it because we needed it.

Get it on GitHub →

The problem it solves

Tuya makes an enormous share of the world's cheap smart plugs and bulbs. They work well enough until the cloud has a bad day, at which point your lights stop answering. Home Assistant can talk to them directly instead, through the excellent tuya-local integration — but only if you have each device's local key.

Getting those used to mean a Tuya developer account, and that route has a trap in it. It depends on an IoT Core subscription whose trial lasts about a month, can only be renewed every six, and is account-level — so creating a fresh project does not reset it. Anything built on it stops working for most people within a month.

There is a better way in: the same device-sharing login Home Assistant's own Tuya integration uses. Read a User Code out of the Smart Life app, scan a QR code, done.

Your Tuya account key ✓ address ✗ Network discovery address ✓ key ✗ Ready for tuya-local joined on device id
Neither source is enough on its own. The cloud knows the key but reports only your public address; the network knows the address but not the key.

What it does

  • Finds every device and its local key, from a QR-code login. No developer account, no cloud project, no subscription.
  • Reconciles that against what is actually on your network, sorting everything into ready, already local, not discovered, and unexplained.
  • Converts devices to tuya-local without you copying anything by hand.
  • Moves the entity ids across, so light.front_porch keeps meaning what it always meant and your automations carry on untouched. Every move can be undone.
  • Re-syncs itself, because a tuya-local entry pins an address, a key and a protocol version, and none of those stay put. When one moves the device goes quiet with nothing in the log naming the cause.

Devices sold under another brand

A great many "not Tuya" devices are Tuya hardware, sold under someone else's brand and paired in that brand's own app — a white-label build with its own account. LEDVANCE and SYLVANIA are supported directly; sign in and their keys join the rest. See Local keys for LEDVANCE, SYLVANIA and other brands.

Getting started

The full walkthrough is in Move Tuya devices to local control. In short: add the repository to your add-on store, install it, and enter the User Code from your Smart Life app.

Why we gave it away

We build VomeHome — hosted Home Assistant with remote access that needs no open ports. This add-on came out of that work, but nothing in it is ours to keep: it is a bridge between two other people's software, solving a problem thousands of people have. It works the same whether or not you have ever heard of us.

If it saves you an afternoon, that is the whole point.

Rather not do this alone?
The Vome assistant will walk you through this guide a step at a time, and can do some of it for you.
Sign in for AI help

Something wrong or missing here? Tell us — these pages are written from real work, so corrections are welcome.