Hay dos vías para integrar dispositivos Tuya: la integración Tuya incluida en Home Assistant, que utiliza la nube, y la integración comunitaria « Tuya Local » para modelos compatibles en la red local. Esta guía parte de Home Assistant 2025.12.2 y contrasta los pasos con la documentación actual de ambos proyectos. Empiece por la integración incluida.
1. Preparación
Instale « Tuya Smart » o « Smart Life » en el teléfono, inicie sesión y añada al menos un dispositivo. Compruebe que funciona en la aplicación. Para vincular la cuenta con Home Assistant necesita la aplicación y otra pantalla donde se mostrará el código QR.
2. Vincular la cuenta Tuya
En la aplicación móvil, abra « Yo » → engranaje de « Ajustes » → « Cuenta y seguridad » → « Código de usuario ». Cópielo. En Home Assistant, abra « Ajustes » → « Dispositivos y servicios » → « Añadir integración », busque « Tuya » e introduzca el código de usuario.
Home Assistant mostrará un código QR. En « Tuya Smart » o « Smart Life », abra el escáner desde « + » o « Añadir dispositivo », escanee el código y confirme el inicio de sesión. Vuelva a Home Assistant, termine la configuración y asigne los dispositivos a zonas si lo desea. Este acceso oficial no requiere crear un proyecto personal de desarrollador Tuya.
3. Comprobar y recargar los dispositivos
Abra la integración Tuya en « Dispositivos y servicios » y pruebe las entidades visibles. No todas las funciones de la aplicación móvil se exponen en Home Assistant. Cuando añada nuevos dispositivos en la aplicación, recargue la integración Tuya para que aparezcan.
4. Opción de control local
« Tuya Local » es una integración comunitaria independiente que requiere HACS. Instálela si necesita control local o funciones adicionales y su modelo es compatible. Tras instalarla y reiniciar Home Assistant, añada « Tuya Local » desde « Dispositivos y servicios ». Su documentación indica que el inicio de sesión en Tuya/Smart Life puede recuperar los datos necesarios; también permite configurar manualmente el identificador del dispositivo, su IP local y la clave local. Trate esta clave como una contraseña.
Solución de problemas
Si falta un dispositivo, confirme primero que aparece conectado en la aplicación móvil y después recargue Tuya. Una función ausente puede deberse a las limitaciones de la interfaz oficial o al modelo. Antes de cambiar a « Tuya Local », revise su lista de compatibilidad y el acceso por red local.
