Home Assistant, LocalTuya adeus delay
- 22 de julho de 2025
Se você utiliza muitos dispositivos Tuya no seu Home Assistant esse post é pra você.
Aqui em casa tenho mais de 25 spots RGB, interruptores Wi-Fi, sensores de presença, sensores de porta e afins. Já me senti muito frustrado ao acionar um comando e perceber um delay de 2, 3 segundos pra que algo aconteça.
No meu caso, esse atraso começou a incomodar principalmente nos cenários envolvendo múltiplos dispositivos, tipo quando uma automação tenta acender tudo junto, claro, aquela situação clássica em que a internet cai e sua casa “inteligente” deixa de ser… tão inteligente assim.
A integração padrão da Tuya funciona. Mas ela depende 100% da internet. Tudo passa pelos servidores da Tuya na nuvem, lá longe. E como todo mundo que já pediu pastel delivery sabe quanto mais longe, mais demorado. Além disso, sem internet = sem automação.
O LocalTuya resolve tudo isso conectando o Home Assistant diretamente a rede local. Resultado é resposta instantânea, controle mesmo sem internet, e automações que funcionam quando você precisa (inclusive de madrugada, quando não dá pra sair tateando parede atrás do interruptor).
Mas claro, nem tudo são flores. Sempre tem aquela parte chata. Ou tinha.
O pulo do gato, o fork com autoimportação via API
Configurar o LocalTuya oficial pode ser bem chato. Você precisava descobrir Device ID, Local Key, IP, e ainda mapear na unha os DPIDs. Pra 1 dispositivo, beleza. Pra 40… boa sorte amigão.
Foi aí que buscando soluções alternatibas eu encontrei o melhor fork possível.
https://xzetsubou.github.io/hass-localtuya/usage/installation/
Esse fork faz o que deveria ser o padrão da integração oficial, puxa tudo da API da Tuya. Ele lista todos os devices, local key, IP, DPID, nomes, e já deixa tudo organizado no Home Assistant. Com alguns cliques, seus devices aparecem magicamente. Ou melhor, automagicamente.
Como configurar
1. Tenha o HACS instalado
Se ainda não tiver, dá uma olhada nesse post aqui.
2. Adicione o repositório do fork no HACS
Use o link abaixo para adicionar o repositório do fork ao HACS:
Depois disso:
- Vá em HACS > Integrações
- Clique em “LocalTuya”
- Instale a integração
- Reinicie o Home Assistant
3. Crie sua conta no Tuya IoT Platform
- Acesse: https://iot.tuya.com
- Registre como “Individual Developer”
- Vá em Cloud > Project > Create Cloud Project
- Nomeie como quiser
- Escolha “Smart Home” e a região America (ou a mais próxima de você)
- Marque todas as permissões de API
4. Vincule sua conta do app Tuya / Smart Life
- Vá em Devices > Link devices by App Account
- Clique em “Add App Account”
- Escaneie o QR code com o app Tuya (em modo desenvolvedor)
- Pronto! Seus dispositivos agora estão visíveis no projeto cloud
5. Adicione o hub no Home Assistant
Você tem duas formas de adicionar o hub (a mágica começa aqui):
Ou vá manualmente em:
- Configurações > Dispositivos e Serviços > + Adicionar Integração > LocalTuya
Agora você escolhe:
-
Usar Cloud API: se você fez o processo acima, insira: ,
Access ID,Access Secret, Região (ex:us,eu, etc.) , Tipo de login (e-mail ou telefone) -
Ou seguir no modo totalmente local: marque a opção “Disable Cloud API” e faça tudo no modo offline (menos prático, mas possível).
Assim que o hub for adicionado, ele vai mostrar todos os dispositivos vinculados e suas funções já mapeadas. Simples assim.
Depois que configurei tudo por esse método:
- As luzes respondem antes de terminar de tocar no botão
- Automações rodam como um relógio, sem delay, sem falha
- Mesmo sem internet, a casa continua funcionando
- Zero mapeamento manual. Sério, zero.
Se você tem muitos devices Tuya, essa é a melhor forma de ter tudo funcionando de verdade.
O fork do Zetsubou virou meu padrão. Não pretendo ter que voltar a integração oficial.
Link direto pra você já começar:
https://xzetsubou.github.io/hass-localtuya/usage/installation/