ntfy — Notificações Push Leves

Já imaginou seu celular te avisando no instante em que um script termina — sem instalar nenhum aplicativo? Essa é a mágica do dia a dia do ntfy: ele transforma qualquer tópico em um canal pub-sub que você pode acionar com uma simples requisição HTTP.

Para usuários do Hermes Agent, o ntfy é o jeito mais fácil de carregar seu agente de IA no bolso. Sem SDK, sem daemon, sem Node.js — apenas um nome de tópico e o aplicativo gratuito do ntfy. Veja como configurar.

Por que o ntfy combina perfeitamente com o Hermes

O Hermes é focado em automação leve. O ntfy segue exatamente essa filosofia:

Zero dependências — o adaptador usa httpx, que já vem com o Hermes.
Qualquer cliente HTTP funciona — curl, Python, até um smartwatch.
Auto-hospedável — rode seu próprio servidor ntfy para tópicos privados, ou use o ntfy.sh público gratuito.

Você assina um tópico no celular, envia uma mensagem para esse tópico pelo Hermes e recebe a resposta como notificação. É mensagem push sem o excesso.

Início Rápido: Assistente de Configuração

O caminho mais rápido é o setup guiado:

hermes gateway setup

Escolha ntfy no menu, digite o nome do seu tópico (ex.: hermes-myname-2026) e pronto. O assistente grava a configuração em ~/.hermes/.env.

Configuração Manual via Variáveis de Ambiente

Prefere editar arquivos? Adicione estas linhas ao ~/.hermes/.env:

NTFY_TOPIC=hermes-myname-2026
NTFY_ALLOWED_USERS=hermes-myname-2026
NTFY_HOME_CHANNEL=hermes-myname-2026

Esse é o mínimo. Veja o que cada variável faz:

Variável	Obrigatória	Finalidade
`NTFY_TOPIC`	Sim	Tópico para assinar (mensagens recebidas)
`NTFY_SERVER_URL`	Não	Padrão `https://ntfy.sh`; aponte para o seu servidor para privacidade
`NTFY_TOKEN`	Não	Token Bearer (`tk_xyz`) ou `user:pass` para autenticação
`NTFY_PUBLISH_TOPIC`	Não	Tópico separado para respostas (padrão: `NTFY_TOPIC`)
`NTFY_MARKDOWN`	Não	Defina `true` para enviar respostas com `X-Markdown: true`
`NTFY_ALLOWED_USERS`	Recomendada	Nomes de tópicos separados por vírgula tratados como IDs de usuário
`NTFY_ALLOW_ALL_USERS`	Não	Permite qualquer publicador — só é seguro para tópicos privados
`NTFY_HOME_CHANNEL`	Não	Tópico padrão para cron / notificações
`NTFY_HOME_CHANNEL_NAME`	Não	Rótulo amigável para o canal principal

O Modelo de Identidade: Leia Antes de Implantar

Aqui está o detalhe do ntfy: ele não tem contas de usuário de verdade. O campo title de uma mensagem é controlado pelo publicador — qualquer um pode falsificá-lo. Por isso, o Hermes não usa title para autorização.

Em vez disso, o próprio nome do tópico é a identidade. Toda mensagem no tópico é tratada como vinda do mesmo usuário lógico. NTFY_ALLOWED_USERS normalmente é só o nome do tópico em si — uma lista de permissão com um único item.

Implicação de segurança: qualquer pessoa que conheça seu tópico pode conversar com seu agente. Para transformar isso em uma fronteira de confiança real:

Auto-hospede o ntfy e proteja o tópico com Controle de Acesso.
Apenas clientes autorizados podem publicar ou assinar.

Uma Dica Prática para o Dia a Dia

Defina NTFY_MARKDOWN=true se quiser respostas formatadas (negrito, listas, blocos de código) exibidas corretamente no aplicativo ntfy. Isso facilita muito a leitura de respostas longas do agente na tela do celular.

Concluindo

O ntfy dá ao Hermes um canal push extremamente simples: assine no celular, configure três variáveis de ambiente e pronto. Sem conta em nuvem, sem serviços extras, sem curva de aprendizado.

Dica final: comece com um tópico único como hermes-<seunome>-<ano> — é praticamente à prova de colisões no servidor público. Depois, quando confiar no fluxo, auto-hospede o ntfy e adicione controle de acesso para um canal realmente privado. Seu agente agora está a um toque de distância.