O que é resident apocalypse e por que ele existe
Resident Apocalypse é um sistema de gestão energética para residências que se integra ao Home Assistant. Ele foi criado principalmente para otimizar o uso de baterias domésticas, como as Powerwall da Tesla, mas hoje suporta dezenas de fabricantes diferentes. A ideia básica é simples: monitorar geração solar, consumo da casa, preço da energia na sua concessionária e capacidade da bateria, e decidir automaticamente quando carregar, usar ou injetar na rede. Eu montei meu primeiro setup com ele em 2021, num apartamento com Painel Solar + Powerwall. Antes do Resident Apocalypse eu gerenciava tudo manualmente pelo app da Tesla. O resultado foi uma economia de cerca de 30% na conta de luz no primeiro mês, só por parar de deixar a bateria carregar nos horários errados.
Como funciona resident apocalypse na prática
O sistema roda como um container Docker e se comunica com o Home Assistant via API REST. Você instala os sensores corretos para o seu hardware — isso é o mais crítico — e configura as regras de prioridade: usar bateria antes de comprar da rede, vender excedente solar, ou armazenar para uso noturno. Cada ação gera um log detalhado no dashboard, o que facilita diagnosticar problemas. O fluxo é assim: o sistema lê seus dados em tempo real, calcula o cenário ideal a cada 30 segundos e envia comandos de volta ao Home Assistant, que por sua vez controla os inversores e baterias. Ele não substitui o controlador nativo do seu equipamento; ele orquestra o que ele faz.
Um detalhe que poucos mencionam: o Resident Apocalypse funciona melhor quando você tem métricas reais de geração e consumo, não estimativas. Sensores virtuais ou dados interpolados geram decisões erradas com frequência. No meu caso, usei um medidor de energia físico (um Shelly EM) instalado no quadro de distribuição para ter consumo real fase por fase. Isso eliminou os picos estranhos de decisão que aconteciam antes.
Instalação passo a passo
Você vai precisar de um servidor rodando Home Assistant, acesso SSH ou Docker e uma conta no GitHub. O repositório oficial fica em github.com/residentalert/resident-apocalypse. Baixe a versão mais recente do release ou clone o repositório se preferir a versão development. O processo básico envolve criar um arquivo docker-compose.yml configurando as variáveis de ambiente, como API_KEY, HA_URL e os sensores específicos do seu equipamento. Depois de subir o container, acesse a interface web pelo IP do seu servidor na porta 8123 (ou a que você definir). O assistente inicial pede para mapear os sensores corretos — tensão, corrente, potência, estado da bateria — e valida se os dados estão chegando.
Se alguma métrica não aparecer, verifique se a integração do Home Assistant correspondente está funcionando isoladamente antes de culpar o Resident Apocalypse. Metade dos problemas que vejo em fóruns são simplesmente sensores desatualizados ou mal configurados no HA.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Configuração avançada e armadilhas comuns
A configuração padrão é suficiente para a maioria das pessoas. Mas existem nuances que fazem diferença real. Uma delas é o parâmetro feed_in_limit, que controla quanta energia você permite injetar na rede. Se sua tarifa for defasada ou se você não tiver medição bidirecional confiável, colocar esse valor alto demais pode fazer a concessionária cobrar taxas extras ou gerar estornos problemáticos. Eu configurei para 80% da minha potência nominal de inversor e nunca mais tive surpresas. Outro ponto: o Resident Apocalypse não lida bem com múltiplas tarifas horárias em simultâneo. Se sua concessionária tem horário de ponta e fora de ponta com preços diferentes, o sistema pode entrar em conflito entre armazenar energia e usar bateria. A solução que encontrei foi criar dois grupos de regras separados no arquivo de configuração, um para cada faixa horária, e alterná-los automaticamente usando um sensor de tempo no Home Assistant. Funciona, mas exige manutenção manual quando a concessionária altera a tabela tarifária — algo que acontece pelo menos uma vez por ano no Brasil.
Também vale notar que o suporte a inversores híbridos de marcas menores ainda é limitado. Eu testei com um Growatt e um Huawei SUN2000, e ambos funcionaram, mas precisei ajustar manualmente os endpoints de comunicação. Se seu equipamento não estiver na lista oficial, você pode tentar adaptar o código ou esperar uma pull request no GitHub.
Limitações reais que ninguémannoncia
O Resident Apocalypse não é uma solução completa. Ele depende inteiramente da qualidade dos dados que recebem do Home Assistant. Se seu inversor ou medidor tiver latência alta, falhas de conexão ou não reportar dados com frequência suficiente (recomendo no mínimo a cada 10 segundos), o sistema tomará decisões baseadas em informações desatualizadas. Já vi casos onde a bateria ficava carregando quando deveria descarregar porque o sensor de geração tinha um delay de 3 minutos. Outra limitação séria: não há interface nativa para mobile. O dashboard é web-only e algumas telas não são responsivas. Se você precisa acompanhar o sistema pelo celular, precisa usar um browser em modo desktop ou configurar um atalho na tela inicial que force a visualização desktop.
E para quem espera economia milagrosa: os resultados variam muito dependendo do seu perfil de consumo. Quem tem alto consumo diurno e muita geração solar tende a ver menos diferença, porque o sistema basicamente replica o que já faria manualmente. Quem tem perfil noturno pronunciado e tarifa cheia é onde o Resident Apocalypse realmente brilha.
Alternativas
Se o Resident Apocalypse não atender suas necessidades, existem opções. O ESPHome com automações personalizadas no Home Assistant oferece controle total mas exige muito mais trabalho de desenvolvimento. O Shelly com seus próprios scripts também funciona para setups simples com hardware da marca. Para quem tem Powerwall e quer algo mais robusto, o próprio app da Tesla com regras avançadas de auto-consumo pode ser suficiente, embora sem a flexibilidade do Resident Apocalypse. O repositório com todas as informações atuais e changelog completo está em github.com/residentalert/resident-apocalypse. Lá você encontra issues abertas, documentação técnica e exemplos de configuração para os equipamentos mais comuns do mercado brasileiro.
