Homebridge Tuya

A community-maintained Homebridge plugin for controlling Tuya devices locally over LAN. Control your supported Tuya accessories locally in HomeKit.

• Supported Device Types
• Installation Instructions
• Configuration
• Known Issues
• Troubleshooting
• Credits
• License
• Donating

Supported Device Types

Click through to the wiki for possible DataPoint "DP" values, then add overrides only as needed.

The runtime-supported config type values are:

AirConditioner, AirPurifier, Convector, CustomMultiOutlet, Dehumidifier, Doorbell, Fan, FanLight, GarageDoor, MultiOutlet, OilDiffuser, Outlet, RGBTWLight, RGBTWOutlet, SimpleBlinds, SimpleDimmer, SimpleDimmer2, SimpleHeater, SimpleLight, Switch, TWLight, VerticalBlindsWithTilt, and WaterValve.

See the Supported Device Types wiki page for examples and device-specific parameters.

Note: Motion, and other sensor types don't behave well with responce requests, so they will not be added.

Installation Instructions

Option 1: Install via Homebridge Config UI X:

Search for "Tuya" in homebridge-config-ui-x and install homebridge-tuya-ai.

Option 2: Manually Install:

sudo npm install -g homebridge-tuya-ai

Verified runtimes

• Homebridge: ^1.11.4 || ^2.0.2
• Node.js: ^22.12.0 || ^24.0.0

Configuration

UI

1. Navigate to the Plugins page in homebridge-config-ui-x.
2. Click the Settings button for the Tuya plugin.
3. Add your device types
4. Add device parameters10
5. Restart Homebridge for the changes to take effect.

Manual

1. Edit the config.json file to add your device types, and parameters.
2. Restart Homebridge

Known Issues

1. If your devices add, but you can't control them, make sure you entered the DataPoint "DP" values for your device.

Contributing

If you have new accessory logic for a new device, please add a function defined by manufacturer, and describe your changes in the readME file.

For local development, use nvm to match the supported Node.js versions:

nvm install
nvm use

Use nvm exec 22 ... and nvm exec 24 ... for cross-version checks during Homebridge 2.0 migration work.

Before opening a PR, run:

nvm exec 22 npm test
nvm exec 24 npm test
nvm exec 24 npm run lint
nvm exec 24 npm run test:coverage
nvm exec 24 npm run test:hb2-docker
node bin/cli.js --help
node bin/cli-find.js --help
node bin/cli-decode.js --help

Credits

• iRayanKhan - developer of the original homebridge-tuya plugin.
• AMoo-Miki - developer of the Tuya-Lan plugin which this plugin is based off.
• mxDanger - Plugin branding.
• CodeTheWeb - developer of TuyaApi, who gratiously provided this repo's name.
• Oznu - developer of Homebridge, added config.schema.json , fixed dependencies, and helped inspire this readME off his gsh plugin.

Go check out my other Homebridge plugins:

• homebridge-futurehome (npm)
• homebridge-tuya-plus (npm)
• homebridge-eqiva-swift-bridge (npm)
• homebridge-intex-plus (npm)
• homebridge-simple-router-status (npm)