Skip to content
Home Assistant TestFlight
Lighting

LocalTuya integration

rospogrigio/localtuya · vv5.2.5

HACSLocal push

local handling for Tuya devices

In Apple Home through HomeKit Bridge

What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.

EntityShows up asNote
lightLight
switchSwitch or outlet
coverBlind, garage door, window or door
climateThermostat
fanFan
binary_sensorSensor (motion, contact, leak, smoke…)
sensorSensor (temperature, humidity, air quality…)
vacuumVacuum (as a switch)
selectMode picker (as switches)

1 report below say how a device from this integration behaves in the Home app.

What people report

Local Tuya control needs local keys and often datapoint mapping. Newer protocol 3.5 devices and sensors with hidden datapoints are unsupported or only in open PRs.

  • Works5
  • Partly works5
  • Not working4
  • Requested4
  • Won’t be supported1
DeviceIn Home AssistantIn Apple HomeWhat they saidSource
Daitsu inverter ACWorks LocalControls everything including beep and display light
Saved copy
My Daitsu Inverter came with Wifi using a rebranded tuya App, works perfect with Local Tuya controlling all, including switch for the “beep” sound, light of the display, etc

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2025-05
Holman WX8 irrigation controllerWorks LocalTuya based but works fine with local Tuya
Saved copy
Holhmann at bunnos. Tuya but works fine with local tuya. WX8 specifically

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2026-10
Reiga smart ceiling fanWorks LocalTuya-compatible control box; fully controllable via LocalTuya
Saved copy
I recently bought both! Ceiling fan was a 'Reiga' smart fan from Amazon. I paid around £200 for it and looks like they're currently on sale. Installation wasn't too bad. The control box is compatible with Tuya/Smart Life, got mine hooked up to Local Tuya in HA and it's fully controllable. At low to medium speeds the fan is pretty quiet so easy to sleep with it on. AC is from Igenix which I got refurbished for £50. It's a glorified tower fan/humidifier but comes with ice blocks to blow slightly colder air. Also integrates with Local Tuya.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2024-06
Tuya switches via LocalTuyaWorks LocalPain to set up but worth it
Saved copy
Sounds like my setup. Love localtuya. Pain to setup but well worth the effort.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2024-11
Tuya WiFi light switchesWorks Local12 switches rock solid for 5+ years locally; fetching local key is a pain
Saved copy
I have 12 tuya light switches running with local integration over wifi, rock solid for 5+ years. In my experience they've been more stable than ZigBee by a large margin. I would not however use them with tuya cloud and getting the local id to set them up locally is simple enough but just a pain in the arse step.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2024-07
Professional weather stationPartly works LocalWind speed, direction, air quality and TVOC missing
Saved copy
ok, I have the same weather station model: fj3395ty. And I do have a few comments that may help you further. I assume that you have already run the tinytuya wizard and scan. 1. You can register the weather station via the SmartLife app. This means that the data from the weather station is forwarded to the continental server (US, EU, etc) and that you can view this data on your mobile in the SmartLife app. In principle, everything you can see on your mobile has been forwarded by your weather station. If you do not see the TOVC data, it will not be forwarded: The TOVC sensor is a local sensor …

Excerpt saved from GitHub on 2026-10-23.

Issue #1796 · 2024-09
Tuya devicesPartly works CloudCloud API changes broke integration; LocalTuya switch painful; several users regret buying
Saved copy
Tuya and all the various brands selling their products under private labels. The integration was a pain to set up, the integration seems to have random issues once it's configured, and trying to switch to Local Tuya is another pain. I have tried switching to Local, and most of my Tuya stuff still isn't working.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2022-01
Tuya devicesPartly works LocalWorks for basic switches; sensors fail and energy monitoring inconsistent
Saved copy
Btw, I've been using Local Tuya since the beginning for better response times and control of devices and it worked pretty nicely for what it worked on, I couldn't get any sensors and the energy monitoring was really inconsistent. It's great for lights, switches and automating between different manufacturers (Tuya switch turns Yeelight on), while the original integration takes as long as 10 minutes to refresh status. This week I've been trying Tuya v2 through HACS and it's way better than the current integration. The delay is *almost* as good as local with not even half the work and more …

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2021-07
Tuya devices via LocalTuyaPartly works LocalNeeds Tuya developer account for local keys, which expire; Tuya Local suggested
Saved copy
Almost same configuration and devices I'm using.. But I'm relied in tuya devices and tp link devices.. Raspberry pi5 with nvme m.2 ssd In India no zigbee touch switches available i think.. That's why relied on tuya.. Local tuya integration I'm using.. Have deco mesh system in my home Broadlink RM4 mini Samsung frame tv with apple tv 4k Using nabucasa

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2025-04
Tuya energy monitoring plugsPartly works LocalEnergy monitoring horrendously inconsistent in LocalTuya
Saved copy
Just a heads up, HA/Tuya just announced a partnership where Tuya is will be developing their own HA integration that will eventually include local control. https://github.com/tuya/tuya-home-assistant I’ve found that LocalTuya works for basic devices/switches but when you get into things like energy monitoring it’s horrendously inconsistent.

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2021-07
Arozen Eon Pro scent diffuserNot working LocalConnects but no datapoints found; works in tuya-local
Saved copy
Environment - Home Assistant: 2026.9.2 - LocalTuya: 5.2.3, installed through HACS - Device: Arozen Eon Pro - Model reported by Tuya: BD1001 - Tuya product ID: `sct7ni7n6uvy8wcm` - Tuya category: `xxj` - Direct Wi-Fi device; Tuya reports `sub: false` ### Problem I’m trying to add an Arozen Eon Pro to LocalTuya. Automatic discovery does not list the device, so I attempted manual configuration. Submitting the device details produces: > Connection to device succeeded but no datapoints found, please try again. Create a new issue and include debug logs if problem persists. ### Steps to reproduce 1. …

Excerpt saved from GitHub on 2026-10-23.

Issue #2287 · 2026-09
Local Tuya and ESPHome devicesNot workingBroken in Home
Bridge detected but accessory cannot be added from Docker
Docker without host networking breaks mDNS pairing
Saved copy
The problem The Issue I recently setup my smart devices on Home Assistant through Local Tuya and ESPHome. Everything works as expected apart from the HomeKit Integration. When I scan the QR Code in the notification through my Apple Home App, it detects the bridge but after a few minutes says - Unable to add the accessory. My Environment I am running HA on a Docker Container on a Windows Based Host. Information that I could gather 1. My HA runs on Docker, which has its own bridge (a virtual network, ex: 172.x.x.x), which is totally different from my LAN's IP subnet (192.x.x.x), which could be …

Excerpt saved from GitHub on 2026-10-23.

Issue #88785 · 2023-02
Sylvania Smart+ bulbsNot working CloudOnly work in Sylvania app; cannot add to Tuya apps or find local key
Saved copy
… with HA, with a local API (no cloud account). I've purchased a few that work with LocalTuya, but they have all died rather quickly. Then I bought some sylvania smart+ bulbs thinking they would last, but I can't add them to Smart Life, Tuya Smart or tuya-cli. They *\_only\_* work for me with the Sylvania app, but I can't find the local key in data/app/com.ledvance.smartplus on a rooted phone. Anyway, what bulbs do you guys use? This should be simple in 2022 lol FYI - I'd like to avoid LocalTuya since it requires the bulb IP. For my home, this is fine but for friends and family I can't keep …

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit thread · 2022-10
Tuya temperature and humidity sensorNot working LocalNo entities created, shows unsupported; empty datapoints
Saved copy
The problem I cannot get temperature and humidity entities from my Tuya T&H Sensor (model: 001TH0202_CB3S, category: tdq). The device is detected in Home Assistant via both Tuya Cloud and LocalTuya integrations, but no entities are created or exposed. The UI shows "unsupported", and the diagnostic JSON has empty function, status_range, and status fields. I tried all protocol versions (3.1, 3.2, 3.3, 3.4), mapped DPS manually (1-8), set scan interval, and confirmed the device IP, ID, and local key (from Tuya IoT). LocalTuya shows an unknown error and doesn’t present any DPS values. Is there …

Excerpt saved from GitHub on 2026-10-23.

Issue #2153 · 2026-01
Klarstein MaxBreeze 15k air conditionerRequested LocalAuto, cold, dry, fan modes proposed in open PR
Saved copy
Adds support for portable air conditioners like the Klarstein MaxBreeze 15k (also confirmed working with Klarstein Smart 12k). Changes: - New HVAC mode set `auto/cold/dry/fan` for ACs with auto/cool/dry/fan modes - New fan mode set `Low/Middle/High` for devices without auto/strong speeds - New preset set `None/Sleep` for devices that use a boolean DP for sleep mode (False = off, True = sleep) The None/Sleep preset integrates fully into the existing generic preset logic without any device-specific special cases. Tested on: Klarstein MaxBreeze 15k Supersedes #2027

Excerpt saved from GitHub on 2026-10-23.

PR #2251 · 2026-06
Ledvance and Sylvania Tuya-based devicesRequestedCloud account support for local key auto-update proposed in open PR
Saved copy
Motivation Ledvance and Sylvania devices are Tuya-based, but they are paired with the vendors' own apps. Those app accounts cannot be linked to a Tuya IoT Platform project, so users currently have no way to use LocalTuya's Cloud API features (local_key retrieval, device names, auto-update after re-pairing). They have to extract keys by hand, again every time a device gets reset. Many Ledvance bulbs reset themselves when the wall switch is toggled a few times. This overlaps with #1131, which also adds an OEM cloud login for Ledvance. This PR is smaller and focused on the local_key workflow: it …

Excerpt saved from GitHub on 2026-10-23.

PR #2301 · 2026-10
Qlima WDH 229 monoblock air conditionerRequested LocalHVAC and fan mode sets proposed in open PR
Saved copy
Add HVAC mode and fan mode sets for Qlima WDH 229 Monoblock Air Conditioner ## Description This PR adds support for the Qlima WDH 229 monoblock air conditioner by adding new HVAC mode and fan mode sets to the Local Tuya climate platform. ## Device Information - Brand: Qlima - Model: WDH 229 (Monoblock Air Conditioner with heating and cooling) - Product Page: https://www.qlima.com/monoblock-airco-cooling-and-heating-wdh-229-white.html - Tuya Protocol: 3.4 - HVAC Mode DP: 4 - Fan Mode DP: 5 ## Tested Modes ### HVAC Modes (DP 4) The device supports these text-based HVAC modes: - `cool` - Cooling …

Excerpt saved from GitHub on 2026-10-23.

PR #2033 · 2025-07
Tuya LED strip WiFi 1L (protocol 3.5)Requested LocalNeeds protocol 3.5 support; open PR tested on it
Saved copy
Resolves #2173 NOTES: - I tested this using the following v3.5 device - "model": "SY-LN-0019", - "name": "LED strip light_WiFi_1L", - "product_id": "sdllh6a0ad0rbivf", - "product_name": "LED strip light_WiFi_1L", - Automatic device discovery does not work for this device - device does not send anything on 6666 or 6667 (normal discovery announcement ports). - I spent some time trying to probe the ports to get an announcement but no luck - This might be the norm for v3.5 discovery unfortunately. - Thus... need to manually input the device/details: [Host; Device ID; Local key; Protocol version;] …

Excerpt saved from GitHub on 2026-10-23.

PR #2178 · 2026-03
Tuya Smart Life Bluetooth sensorWon’t be supportedLocalTuya only supports WiFi devices, not Zigbee or Bluetooth; ESPHome BLE works
Saved copy
Local tuya only works with wifi devices, they have not (yet) integrated devices that need the multiprotocol hub eg ZigBee and Bluetooth devices

Excerpt saved from the Arctic Shift Reddit archive on 2026-10-23.

Reddit comment · 2023-11

Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.

How it connects

Local push

Talks to the device on your network, and the device tells Home Assistant the moment something changes.

Details

Installs (analytics)33,395 (4.71%)
GitHub stars4,005
Latest versionv5.2.5 (2026-01-29)
Set up in the UIYes
Maintainers@rospogrigio, @postlund
LicenseGPL-3.0

Notable forks

Forks with stars, or with code pushed at least 90 days after the original’s last push. Useful when the original goes quiet.

ForkStarsLast pushDescription
xZetsubou/hass-localtuya Newer code★ 12542026-10-21🔹 A Home Assistant integration to handle Tuya devices locally "fork from localtuya"
leeyuentuen/localtuya★ 962025-05-12local handling for Tuya devices
avataar/localtuya★ 202026-03-07local handling for Tuya devices
Bildass/localtuya Newer code★ 172026-09-27local handling for Tuya devices
darek-margas/localtuya★ 102023-05-05local handling for Tuya devices

In ReReHome

Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.

Bridges get their own settings page listing the accessories behind them.