Tuya Local is a Home Assistant integration that enables local control of Tuya-firmware devices over WiFi without routing through the Tuya cloud.
The integration solves the problem of cloud dependency for Tuya device control by establishing direct local connections. This approach improves speed and reliability compared to cloud-based control, and can unlock device features or entire devices that the Tuya cloud API does not expose. The integration supports a wide range of device types including lights, switches, climate devices, fans, heaters, humidifiers, dehumidifiers, and pool heaters. Devices connect over WiFi, with limited support available for hub-connected devices. The tool does not prevent devices from communicating with Tuya's cloud servers; rather, it provides a local alternative that complements existing cloud connectivity.
Developers should adopt this integration if they want faster, more reliable control of Tuya devices within Home Assistant and need access to features unavailable through the cloud API. The project suits any Home Assistant setup with Tuya-compatible devices. The README names an alternative integration, rospogrigio/localtuya, which may be easier to set up for devices not supported here or for users preferring a more recent fork. One important consideration is that Tuya devices typically support only one local connection at a time, so users must ensure other local Tuya integrations, mobile apps, and third-party software are not simultaneously connecting to the same devices. Configuration can be automated by logging into the Tuya cloud to retrieve device information and local connection data, or performed manually by providing device details directly.
The project maintains an active acknowledgements file recognizing many contributors. The README explicitly invites issue reports and pull requests, indicating openness to community participation and feedback.
