LocalTuya integration
rospogrigio/localtuya · vv5.2.5
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.
| Entity | Shows up as | Note |
|---|---|---|
light | Light | |
switch | Switch or outlet | |
cover | Blind, garage door, window or door | |
climate | Thermostat | |
fan | Fan | |
binary_sensor | Sensor (motion, contact, leak, smoke…) | |
sensor | Sensor (temperature, humidity, air quality…) | |
vacuum | Vacuum (as a switch) | |
select | Mode 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
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| Daitsu inverter AC | Works Local | Controls everything including beep and display lightSaved copyMy 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 controller | Works Local | Tuya based but works fine with local TuyaSaved copyHolhmann 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 fan | Works Local | Tuya-compatible control box; fully controllable via LocalTuyaSaved copyI 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 LocalTuya | Works Local | Pain to set up but worth itSaved copySounds 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 switches | Works Local | 12 switches rock solid for 5+ years locally; fetching local key is a painSaved copyI 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 station | Partly works Local | Wind speed, direction, air quality and TVOC missingSaved copyok, 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 devices | Partly works Cloud | Cloud API changes broke integration; LocalTuya switch painful; several users regret buyingSaved copyTuya 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 devices | Partly works Local | Works for basic switches; sensors fail and energy monitoring inconsistentSaved copyBtw, 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 LocalTuya | Partly works Local | Needs Tuya developer account for local keys, which expire; Tuya Local suggestedSaved copyAlmost 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 plugs | Partly works Local | Energy monitoring horrendously inconsistent in LocalTuyaSaved copyJust 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 diffuser | Not working Local | Connects but no datapoints found; works in tuya-localSaved copyEnvironment - 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 devices | Not working | Broken in Home Bridge detected but accessory cannot be added from Docker | Docker without host networking breaks mDNS pairingSaved copyThe 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+ bulbs | Not working Cloud | Only work in Sylvania app; cannot add to Tuya apps or find local keySaved 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 sensor | Not working Local | No entities created, shows unsupported; empty datapointsSaved copyThe 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 conditioner | Requested Local | Auto, cold, dry, fan modes proposed in open PRSaved copyAdds 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 devices | Requested | Cloud account support for local key auto-update proposed in open PRSaved copyMotivation 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 conditioner | Requested Local | HVAC and fan mode sets proposed in open PRSaved copyAdd 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 Local | Needs protocol 3.5 support; open PR tested on itSaved copyResolves #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 sensor | Won’t be supported | LocalTuya only supports WiFi devices, not Zigbee or Bluetooth; ESPHome BLE worksSaved copyLocal 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 stars | 4,005 |
| Latest version | v5.2.5 (2026-01-29) |
| Set up in the UI | Yes |
| Maintainers | @rospogrigio, @postlund |
| License | GPL-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.
| Fork | Stars | Last push | Description |
|---|---|---|---|
| xZetsubou/hass-localtuya Newer code | ★ 1254 | 2026-10-21 | 🔹 A Home Assistant integration to handle Tuya devices locally "fork from localtuya" |
| leeyuentuen/localtuya | ★ 96 | 2025-05-12 | local handling for Tuya devices |
| avataar/localtuya | ★ 20 | 2026-03-07 | local handling for Tuya devices |
| Bildass/localtuya Newer code | ★ 17 | 2026-09-27 | local handling for Tuya devices |
| darek-margas/localtuya | ★ 10 | 2023-05-05 | local 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.
Sources
- Documentation: https://github.com/rospogrigio/localtuya/
- Source code: https://github.com/rospogrigio/localtuya
- Issues: https://github.com/rospogrigio/localtuya/issues
- HACS: https://hacs.xyz