Tuya Local
homebridge-tuya-local · v3.1.5
Controls Tuya lights, plugs, switches, fans, heaters, purifiers and more locally over the LAN without the cloud.
What it says it supports
Brands
- Tuya
Devices it names
- Air conditioners
- Air purifiers
- Convectors
- Dehumidifiers
- Dimmers
- Fans
- Garage doors
- Heaters
- RGB lights
- Oil diffusers
- Outlets
- Presence sensor ZY-M100
- Switches
Shows up in Apple Home as from its README
- Lights
- Outlets
- Switches
- Air Conditioners and Heaters
- Air Purifiers
- Fans
- Humidifiers
- Garage Door Openers
- Sensors
Sensor readings in its code
What people report
Local Tuya plugin with 3.5 protocol support and Homebridge 2 fixes; supports fans, ACs and presence sensors.
- Works3
- Requested1
| Device | Status | What they said | Source |
|---|---|---|---|
| Tuya fan and fan-light accessories | Works | Improved fan speed and brightness controlSaved copyAdded the accessories to the configuration schema allowing UI Config Support configurable fan speed for fan accessories Improved support for brightness control on fan light accessories including configurable brightness steps (my fan has 9 total) Excerpt saved from GitHub on 2026-10-22. | PR #8 · 2024-01 |
| Tuya mmWave human presence sensor | Works | Added as occupancy sensor with light sensorSaved copyTuya mmwave Human Presence Sensor (ZY-M100), added as an occupancy sensor with an occupancy service and a light sensor service Excerpt saved from GitHub on 2026-10-22. | PR #3 · 2023-12 |
| Tuya protocol 3.5 devices | Works | 3.5 protocol support added in v3.1.0Saved copy[!NOTE] The previous plugin from iRayan has again entered the state of dormancy so I was left to update my own fork and dig around to add 3.5 protocol support to make my new Tuya devices work with my existing homebridge setup🥇 . Add Tuya 3.5 Protocol Support Minor fixes related to IP change detection logic etc. Formatting changes Excerpt saved from GitHub on 2026-10-22. | PR #16 · 2025-12 |
| Tuya portable air conditioner | Requested | PR to add portable AC closed unmergedSaved copyThe original text was already deleted or overwritten when we archived it. | PR #18 · 2026-04 |
Gathered from the plugin’s GitHub issues, pull requests, discussions, wiki and docs, and from r/homebridge. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local
Local Tuya protocol (incl. v3.5) over LAN
You’ll need
- Device DataPoint (DP) values
- Device local keys
Compatibility
| Verified by Homebridge | No |
|---|---|
| Homebridge versions | >=0.4.0 |
| Homebridge 2.0 | No |
| Node.js | >=8.6.0 |
| Settings in Homebridge UI | Yes |
| Matter | No |
| Platform name | TuyaLan |
| License | MIT |
Community signals
| Downloads a week | 35 |
|---|---|
| Downloads a month | 227 |
| GitHub stars | 10 |
| Open issues | 0 |
| Closed issues | 0 |
| Last code push | 2026-10-18 |
| Latest version | 3.1.5 (2026-04-25) |
| First published | 2023-11-01 |
| Releases | 11 |
In ReReHome
Whatever this plugin publishes reaches Apple Home as a normal HomeKit accessory behind your Homebridge bridge, so ReReHome shows and controls it like any other.
Bridges get their own settings page listing the accessories behind them.
Caveats from the README
- Motion and other sensor types are not added generally
- Uncontrollable devices usually need correct DP values
HomeKit services in its code
Found by scanning the published npm package. A plugin can register a service only for some devices.
- AirPurifier
- AirQualitySensor
- Fan
- GarageDoorOpener
- HeaterCooler
- HumidifierDehumidifier
- HumiditySensor
- LightSensor
- Lightbulb
- LockMechanism
- OccupancySensor
- Outlet
- Switch
- TemperatureSensor
- Valve
- WindowCovering





