Skip to content
Homebridge TestFlight
Tuya

Tuya Local

homebridge-tuya-local · v3.1.5

Local

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

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
DeviceStatusWhat they saidSource
Tuya fan and fan-light accessoriesWorksImproved fan speed and brightness control
Saved copy
Added 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 sensorWorksAdded as occupancy sensor with light sensor
Saved copy
Tuya 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 devicesWorks3.5 protocol support added in v3.1.0
Saved 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 conditionerRequestedPR to add portable AC closed unmerged
Saved copy

The 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 HomebridgeNo
Homebridge versions>=0.4.0
Homebridge 2.0No
Node.js>=8.6.0
Settings in Homebridge UIYes
MatterNo
Platform nameTuyaLan
LicenseMIT

Community signals

Downloads a week35
Downloads a month227
GitHub stars10
Open issues0
Closed issues0
Last code push2026-10-18
Latest version3.1.5 (2026-04-25)
First published2023-11-01
Releases11

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