ntfy — Notifiche Push Leggere | Easy Understand Hermes Agent

Hai mai desiderato che il tuo telefono ti avvisasse nel momento esatto in cui uno script termina—senza installare una sola app? È la magia quotidiana di ntfy: trasforma qualsiasi argomento in un canale pub-sub che puoi “pingare” con una semplice richiesta HTTP.

Per gli utenti di Hermes Agent, ntfy è il modo più semplice per portare il tuo agente AI in tasca. Niente SDK, niente demone, niente Node.js—solo un nome di argomento e l’app mobile gratuita di ntfy. Ecco come configurarlo.

Perché ntfy si adatta perfettamente a Hermes

Hermes punta tutto sull’automazione leggera. ntfy rispecchia perfettamente questa filosofia:

Zero dipendenze — l’adattatore usa httpx, già incluso in Hermes.
Qualsiasi client HTTP funziona — curl, Python, persino uno smartwatch.
Auto-ospitabile — puoi gestire il tuo server ntfy per argomenti privati, oppure usare il pubblico gratuito ntfy.sh.

Ti iscrivi a un argomento sul telefono, invii un messaggio a quell’argomento da Hermes e ricevi la risposta come notifica. È messaggistica push senza il superfluo.

Avvio rapido: procedura guidata

Il percorso più veloce è la configurazione guidata:

hermes gateway setup

Scegli ntfy dal menu, inserisci il nome del tuo argomento (es. hermes-mionome-2026), e il gioco è fatto. La procedura scrive la configurazione in ~/.hermes/.env.

Configurazione manuale tramite variabili d’ambiente

Preferisci modificare i file? Aggiungi queste righe a ~/.hermes/.env:

NTFY_TOPIC=hermes-mionome-2026
NTFY_ALLOWED_USERS=hermes-mionome-2026
NTFY_HOME_CHANNEL=hermes-mionome-2026

Questo è il minimo indispensabile. Ecco cosa fa ogni variabile:

Variabile	Obbligatoria	Scopo
`NTFY_TOPIC`	Sì	Argomento a cui iscriversi (messaggi in arrivo)
`NTFY_SERVER_URL`	No	Predefinito `https://ntfy.sh`; punta al tuo server per la privacy
`NTFY_TOKEN`	No	Token Bearer (`tk_xyz`) o `utente:password` per l’autenticazione
`NTFY_PUBLISH_TOPIC`	No	Argomento separato per le risposte (predefinito: `NTFY_TOPIC`)
`NTFY_MARKDOWN`	No	Imposta `true` per inviare risposte con `X-Markdown: true`
`NTFY_ALLOWED_USERS`	Consigliata	Elenco di nomi di argomenti separati da virgole trattati come ID utente
`NTFY_ALLOW_ALL_USERS`	No	Consenti a tutti i publisher—sicuro solo per argomenti privati
`NTFY_HOME_CHANNEL`	No	Argomento predefinito per cron / notifiche
`NTFY_HOME_CHANNEL_NAME`	No	Etichetta leggibile per il canale principale

Il modello di identità: leggilo prima di implementare

Ecco il punto critico di ntfy: non ha veri account utente. Il campo title di un messaggio è controllato dal publisher—chiunque può falsificarlo. Quindi Hermes non usa title per l’autorizzazione.

Invece, il nome dell’argomento stesso è l’identità. Ogni messaggio sull’argomento viene trattato come proveniente dallo stesso utente logico. NTFY_ALLOWED_USERS di solito è semplicemente il nome dell’argomento stesso—una lista consentita con una sola voce.

Implicazione di sicurezza: chiunque conosca il tuo argomento può parlare con il tuo agente. Per creare un vero confine di fiducia:

Auto-ospita ntfy e blocca l’argomento con il Controllo Accessi.
Solo i client autorizzati possono pubblicare o iscriversi.

Un consiglio pratico per l’uso quotidiano

Imposta NTFY_MARKDOWN=true se vuoi risposte formattate (grassetto, elenchi, blocchi di codice) visualizzate correttamente nell’app ntfy. Rende le risposte lunghe dell’agente molto più facili da scansionare sullo schermo del telefono.

Per concludere

ntfy offre a Hermes un canale push estremamente semplice: iscriviti sul telefono, configura tre variabili d’ambiente e sei operativo. Nessun account cloud, nessun servizio extra, nessuna curva di apprendimento.

Consiglio finale: inizia con un argomento unico come hermes-<tuonome>-<anno>—è praticamente a prova di collisione sul server pubblico. Poi, una volta che ti fidi del flusso di lavoro, auto-ospita ntfy e aggiungi il controllo accessi per un canale davvero privato. Il tuo agente ora è a un “bip” di distanza.