Tuya / Cloud Workarounds

Tuya is the OEM behind a third of the cheap "Smart Life," "Aubess," "Lonsonho," "Lidl Silvercrest," and unbranded white-box Wi-Fi / Zigbee devices on Amazon and AliExpress. By default, every one of them phones home to Tuya's cloud. The good news: there's a vibrant ecosystem keeping them local.

For the firmware platforms that flash these see IoT Firmware Platforms; for Zigbee Tuya devices see Zigbee Stacks & Coordinators; for the hub above this layer see Smart Home Hubs.

The 2026 reality

Tuya devices fall into four buckets:

1. Wi-Fi with ESP82xx / ESP32 — flash to ESPHome / Tasmota directly.
2. Wi-Fi with Beken BK72xx or Realtek RTL87xx — historically a problem; now flashable with LibreTiny (ESPHome / Tasmota's compatibility layer).
3. Zigbee — pair to Zigbee2MQTT and forget Tuya exists; works with most Tuya Zigbee devices.
4. Closed cloud-only — fall back to LocalTuya (no firmware flash) or accept the cloud.

LocalTuya — keep stock firmware, lose the cloud

• ★ LocalTuya — Home Assistant integration that talks Tuya's local LAN protocol directly to the device. No flashing required. You need the device's local key (extractable via Tuya IoT developer console, free).
  • https://github.com/rospogrigio/localtuya
• ★ tinytuya — Python lib + CLI; the underlying protocol implementation; useful for scripting / extracting local keys.
  • https://github.com/jasonacox/tinytuya
• HA's official "Tuya" integration — uses Tuya's cloud, requires a paid Tuya IoT cloud project (free trial expires); rate-limited; works but locks you to Tuya's uptime. Prefer LocalTuya unless you need things LocalTuya can't do.

Flashing Tuya Wi-Fi devices

• ★ tuya-convert — over-the-air flasher for older Tuya firmware (pre-March 2021); exploits an OTA quirk; no soldering. Increasingly fewer devices vulnerable.
  • https://github.com/ct-Open-Source/tuya-convert
• ★ CloudCutter — newer; exploits the Tuya cloud handshake to flash from an OTA update server you stand up locally. Works on devices tuya-convert doesn't.
  • https://github.com/tuya-cloudcutter/tuya-cloudcutter
• OTA from inside the device's web UI — a few open Tuya firmwares allow direct OTA. Rare.
• Soldering UART + esptool / bk7231tools — when OTA exploits don't work, open the device, find the TX/RX pads, flash with the chip-specific tool. Always the fallback.

LibreTiny — the BK72xx / RTL87xx breakthrough

• ★ LibreTiny (was LibreTuya) — drop-in Arduino-core for Beken BK72xx, BK7231, RTL8710, RTL8720 chips. ESPHome and Tasmota now compile for these chips natively. No more "this device has a Beken chip, you can't have nice things."
  • https://github.com/libretiny-eu/libretiny
• This is the reason Tuya devices are usable in 2026. Pre-2023, half the cheap "smart bulbs" used Beken and were write-offs once flashed. LibreTiny fixed it.

bk7231tools — Beken-specific flasher

• bk7231tools — Python CLI for reading / writing / unprotecting Beken flash. Pairs with LibreTiny; needed for soldering-fallback flashes.
  • https://github.com/openshwprojects/OpenBK7231T_App
• OpenBK7231T_App / OpenBeken — alternative open firmware for Beken specifically; web UI; competing with Tasmota-via-LibreTiny.

ESPurna / Tasmota for old ESP-based Tuya

• See IoT Firmware Platforms. On older ESP82xx Tuya devices, Tasmota + Tuya-Convert was the classic flow; still works on devices found in the wild.

The blakadder.com device database

• ★ blakadder.com/templates — community-maintained directory of Tuya / Tasmota / ESPHome devices; tells you the chip, firmware version, exploit eligibility, and recommended flash. Always check here first before buying or flashing.
  • https://blakadder.com

Zigbee Tuya — the easier path

Tuya's Zigbee devices are excellent in 2026. Pair them to Zigbee2MQTT and they show up properly typed (almost all are in the zigbee-herdsman-converters library). You bypass Tuya entirely; no flashing needed.

• zigbee2mqtt-supported-devices — search "tuya" in Z2M's device database; thousands of Tuya Zigbee devices supported.
• TS0601-class devices — Tuya's "extended" Zigbee schema; Z2M handles them via custom converters.

The bog-standard cheap Aubess / NEDIS / Lidl Zigbee plug or sensor at €5 is almost always a Tuya OEM and almost always "just works" via Z2M.

Practical guidance

• ★ Always check blakadder.com / Z2M's device DB before buying. Five minutes' research saves you a flash session.
• ★ Buy known-flashable models if Wi-Fi. Athom, Sonoff, Shelly already ship open. Cheap Tuya on Amazon is a flashing project.
• Block Tuya devices from the internet at your firewall. Even after flashing, until you're sure, isolate them.
• Save the device's local key when you set it up via the Tuya app. The Tuya app/cloud is the only easy way to extract the key initially; LocalTuya needs it.
• Tuya frequently changes their cloud handshake. A cloud-cutter exploit that worked last month might not work today; check the issue tracker.

Pick this if…

• Tuya Zigbee device, default path: Zigbee2MQTT. Done.
• Tuya Wi-Fi, no flash: LocalTuya.
• Tuya Wi-Fi, want to flash, OTA-only: tuya-convert (older devices) or CloudCutter (newer).
• Tuya device with a Beken / Realtek chip: ESPHome / Tasmota via LibreTiny.
• Buying a new Tuya device: check blakadder.com and Z2M's DB first.