ntfy — Notifications Push Légères

Vous êtes-vous déjà demandé si votre téléphone pouvait vous prévenir dès qu’un script se termine, sans que vous ayez à installer la moindre application ? C’est la magie du quotidien avec ntfy : il transforme n’importe quel sujet en canal pub-sub que vous pouvez interroger avec une simple requête HTTP.

Pour les utilisateurs de Hermes Agent, ntfy est le moyen le plus simple d’emporter votre agent IA dans votre poche. Pas de SDK, pas de démon, pas de Node.js — juste un nom de sujet et l’application mobile gratuite ntfy. Voici comment le configurer.

Pourquoi ntfy s’accorde parfaitement avec Hermes

Hermes est conçu pour l’automatisation légère. ntfy correspond parfaitement à cette philosophie :

• Zéro dépendance — l’adaptateur utilise httpx, déjà inclus avec Hermes.
• N’importe quel client HTTP fonctionne — curl, Python, même une montre connectée.
• Auto-hébergeable — faites tourner votre propre serveur ntfy pour des sujets privés, ou utilisez le serveur public gratuit ntfy.sh.

Vous vous abonnez à un sujet sur votre téléphone, envoyez un message à ce sujet depuis Hermes, et recevez la réponse sous forme de notification. C’est de la messagerie push sans le superflu.

Démarrage rapide : l’assistant de configuration

Le chemin le plus rapide est la configuration guidée :

hermes gateway setup

Choisissez ntfy dans le menu, saisissez le nom de votre sujet (par exemple, hermes-myname-2026), et c’est tout. L’assistant écrit la configuration dans ~/.hermes/.env.

Configuration manuelle via les variables d’environnement

Vous préférez éditer des fichiers ? Ajoutez ceci à ~/.hermes/.env :

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

C’est le minimum. Voici ce que fait chaque variable :

Variable	Requise	Rôle
NTFY_TOPIC	Oui	Sujet auquel s’abonner (messages entrants)
NTFY_SERVER_URL	Non	Par défaut https://ntfy.sh ; pointez vers un serveur auto-hébergé pour plus de confidentialité
NTFY_TOKEN	Non	Jeton Bearer (tk_xyz) ou user:pass pour l’authentification
NTFY_PUBLISH_TOPIC	Non	Sujet séparé pour les réponses (par défaut NTFY_TOPIC)
NTFY_MARKDOWN	Non	Mettez true pour envoyer les réponses avec X-Markdown: true
NTFY_ALLOWED_USERS	Recommandée	Noms de sujets séparés par des virgules, traités comme des identifiants utilisateur
NTFY_ALLOW_ALL_USERS	Non	Autorise tous les éditeurs — sûr uniquement pour les sujets privés
NTFY_HOME_CHANNEL	Non	Sujet par défaut pour les tâches cron / notifications
NTFY_HOME_CHANNEL_NAME	Non	Libellé lisible pour le canal principal

Le modèle d’identité : à lire avant de déployer

Voici le point crucial avec ntfy : il n’a pas de véritables comptes utilisateurs. Le champ title d’un message est contrôlé par l’éditeur — n’importe qui peut l’usurper. Hermes n’utilise donc pas title pour l’autorisation.

À la place, le nom du sujet lui-même est l’identité. Chaque message sur le sujet est considéré comme provenant du même utilisateur logique. NTFY_ALLOWED_USERS est généralement simplement le nom du sujet lui-même — une liste d’autorisation à une seule entrée.

Implication en matière de sécurité : toute personne qui connaît votre sujet peut parler à votre agent. Pour créer une véritable frontière de confiance :

• Auto-hébergez ntfy et verrouillez le sujet avec le Contrôle d’accès.
• Seuls les clients autorisés peuvent publier ou s’abonner.

Un conseil pratique pour l’usage quotidien

Définissez NTFY_MARKDOWN=true si vous souhaitez que les réponses formatées (gras, listes, blocs de code) s’affichent correctement dans l’application ntfy. Cela rend les longues réponses de l’agent beaucoup plus faciles à parcourir sur un écran de téléphone.

Pour conclure

ntfy offre à Hermes un canal push d’une simplicité enfantine : abonnez-vous sur votre téléphone, configurez trois variables d’environnement, et c’est parti. Pas de compte cloud, pas de services supplémentaires, pas de courbe d’apprentissage.

Dernier conseil : commencez avec un sujet unique comme hermes-<votrenom>-<année> — c’est pratiquement infaillible sur le serveur public. Ensuite, une fois que vous avez confiance dans le flux de travail, auto-hébergez ntfy et ajoutez un contrôle d’accès pour un canal vraiment privé. Votre agent n’est plus qu’à une notification de vous.

---