LocalTuya integration for Home Assistant (Marketplace integration)

Installs: 33.4k sharing analytics
GitHub stars: 4k
Connection: Works locally
Upkeep: No update in 6 to 18 months
Version: v5.2.5, January 29, 2026
Category: Hubs and protocols, Smart home hubs
Kind: Marketplace integration
Brand: Tuya
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: localtuya
Source: github.com/rospogrigio/localtuya
Issues: Report an issue

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

Screenshots From the README of rospogrigio/localtuya.

About

LocalTuya integration handles Tuya-based devices locally from Home Assistant instead of through the cloud. Status changes are pushed from the devices rather than polled, so updates arrive quickly, including when a device is operated by hand. It provides binary sensors, climate, covers, fans, lights, numbers, selects, sensors, switches and vacuums, and supports energy monitoring such as voltage and current on compatible devices. Tuya protocol versions 3.1 to 3.4 are supported. A Tuya IoT Cloud account can optionally be linked to retrieve device local keys, and it is only called at startup or when a key needs updating. Setup runs in the UI, where devices are added and their entities configured, and it also offers a reload action, a datapoint setting action and a diagnostics download.

Automatic summary of the README and code of rospogrigio/localtuya. 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.

Provides

Lights
Climate
Fans
Covers
Vacuums
Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Cloud API account configuration

API server region
Client ID
Secret
User ID
Username
Do not configure a Cloud API account

After setup

Add a new device
Edit a device
Reconfigure Cloud API account
Discovered Devices
Configured Devices
Max Temperature Constant (optional)
Min Temperature Constant (optional)
HVAC Fan Mode DP (optional)
HVAC Fan Mode Set (optional)
HVAC Swing Mode DP (optional)
HVAC Swing Mode Set (optional)
API server region
Client ID
Secret
User ID
Username
Do not configure Cloud API account
Name
Host
Device ID
Local key
Protocol Version
Enable debugging for this device (debug must be enabled also in configuration.yaml)
Scan interval (seconds, only when not updating automatically)
Entities (uncheck an entity to remove it)
Add more entities in 'edit device' mode
Manual DPS to add (separated by commas ',') - used when detection is not working (optional)
DPIDs to send in RESET command (separated by commas ',')- Used when device does not respond to status requests after turning on (optional)
Platform
Do not add any more entities
ID
Friendly name
Current
Current Consumption
Voltage
Open_Close_Stop Commands Set
Positioning mode
Current Position (for *position* mode only)
Set Position (for *position* mode only)
Invert 0-100 position (for *position* mode only)
Full opening time, in secs. (for *timed* mode only)
Unit of Measurement
Device Class
Scaling Factor
On Value

Texts from the code of rospogrigio/localtuya.

Actions

ReloadReload localtuya and reconnect to all devices.
Set datapointChange the value of a datapoint (DP)Fields: Device ID, DP, Value

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

A Home Assistant custom Integration for local handling of Tuya-based devices.
This custom integration updates device status via pushing updates instead of polling, so status updates are fast (even when manually operated). The integration also supports the Tuya IoT Cloud APIs, for the retrieval of info and of the local_keys of the devices.

From the README of rospogrigio/localtuya, GNU GPL v3.0. Shortened.