Tuya Local for Home Assistant (Marketplace integration)

Installs: 20.4k sharing analytics
GitHub stars: 3.6k
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: 2026.10.0, October 27, 2026
Category: Hubs and protocols, Smart home hubs
Kind: Marketplace integration
Brand: Tuya
Needs: Added as a custom repository in the Marketplace
Domain: tuya_local
Source: github.com/make-all/tuya-local
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Tuya Local is an integration that connects Tuya devices to Home Assistant over the local network instead of the Tuya cloud. It supports devices running Tuya firmware over WiFi, with limited support for devices connected through hubs or gateways. Entities are created across many platforms, including climate, fans, lights, locks, sensors, switches, vacuums and water heaters, with device types chosen during setup. Devices are added in the interface, either by logging in to Tuya to pick a device from the account or by entering the address, device ID and local key manually. It also offers an action for sending learned remote commands to infrared emitters and a diagnostics download for bug reports. Devices still report status to the Tuya cloud, and many Tuya devices accept only one local connection at a time.

Automatic summary of the README and code of make-all/tuya-local. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Lights
Climate
Water heaters
Humidifiers
Fans
Covers
Valves
Cameras
Locks
Alarms
Media
Remotes
Vacuums
Switches
Sensors

Setting it up

Add its repository to the Marketplace as a custom repository and install it, then restart Home Assistant and add it under Settings, Devices and services.

Configure your Tuya Local device

Setup choice:

Login to Tuya

User code:

Choose the device to add

Choose device:
Choose gateway:

Configure your Tuya Local device

IP address or hostname
Device ID (or the hub's Device ID for devices connected via gateway)
Local key
Protocol version (try auto if not known)
Poll only (try this if your device does not work fully)
Sub device node_id or uuid (for devices connected via gateway)

Choose the type of device

Device type

Also asked when at the choose the type of device step.

Device details

Name

After setup

IP address or hostname
Local key
Protocol version (try auto if not known)
Poll only (try this if your device does not work fully)

Texts from the code of make-all/tuya-local.

Entities

Binary sensorsDirection, Defrost, Delayed fan operation, Tank, Wake, Rinse aid, and 2 more
ButtonsFactory reset, Filter reset, Alarm off, Alarm snooze, Radio seek, and 1 more
ClimateAir conditioner, Cold water dispenser, Thermostat, Heater
EventsAlarm, Notification
FansAir purifier, Aroma diffuser, Dehumidifier, Fan, Ventilation
LightsBacklight, Display, Embers, Flame, Indicator, and 7 more
LocksChild lock
NumbersFlame level, Manual feed, Maximum temperature, Minimum temperature, Threshold, and 8 more
SelectsCurrency, Heat pump mode, Initial state, Kettle mode, Language, and 32 more
SensorsAmbient temperature, Inlet temperature, Outlet temperature, Cleanliness, Air quality, and 11 more
SwitchesTimer, Empty tank, Fill tank, Anti-frost, Auto clean, and 23 more
TextsMeal plan, Scene, Schedule, Alarm settings, Sleep settings, and 1 more
TimesReservation time, Cooking time, Timer, Clock time
Water heatersWater heater, Kettle, Hot water dispenser

Actions

Send a learned remote command to infraredSend a remote command that was previously learned by the remote entity to any infrared emitter.Fields: Emitter, Command, Device

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

Please report any issues and feel free to raise pull requests. Many others have contributed their help already.
This is a Home Assistant integration to support devices running Tuya firmware without going via the Tuya cloud. Devices are supported over WiFi, limited support for devices connected via hubs is available.

From the README of make-all/tuya-local, MIT License. Shortened.