ntfy — Notificaciones Push Ligeras

¿Alguna vez has deseado que tu teléfono te avise en el momento exacto en que un script termina, sin tener que instalar una sola aplicación? Esa es la magia cotidiana de ntfy: convierte cualquier tema en un canal de publicación-suscripción al que puedes hacer ping con una simple petición HTTP.

Para los usuarios de Hermes Agent, ntfy es la forma más fácil de llevar tu agente de IA en el bolsillo. Sin SDK, sin demonios, sin Node.js — solo un nombre de tema y la aplicación móvil gratuita de ntfy. Aquí te explicamos cómo conectarlo.

Por qué ntfy encaja perfectamente con Hermes

Hermes se centra en la automatización ligera. ntfy encaja perfectamente con esa filosofía:

• Cero dependencias — el adaptador usa httpx, que ya viene incluido con Hermes.
• Funciona con cualquier cliente HTTP — curl, Python, incluso un smartwatch.
• Auto-alojable — ejecuta tu propio servidor ntfy para temas privados, o usa el público gratuito ntfy.sh.

Te suscribes a un tema en tu teléfono, envías un mensaje a ese tema desde Hermes y recibes la respuesta como notificación. Es mensajería push sin el peso innecesario.

Inicio rápido: Asistente de configuración

La vía más rápida es la configuración guiada:

hermes gateway setup

Elige ntfy en el menú, introduce el nombre de tu tema (por ejemplo, hermes-myname-2026), y listo. El asistente escribe la configuración en ~/.hermes/.env.

Configuración manual mediante variables de entorno

¿Prefieres editar archivos? Añade esto a ~/.hermes/.env:

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

Eso es el mínimo. Aquí tienes qué hace cada variable:

Variable	¿Requerida?	Propósito
NTFY_TOPIC	Sí	Tema al que suscribirse (mensajes entrantes)
NTFY_SERVER_URL	No	Por defecto https://ntfy.sh; apunta a un servidor auto-alojado para mayor privacidad
NTFY_TOKEN	No	Token Bearer (tk_xyz) o usuario:contraseña para autenticación
NTFY_PUBLISH_TOPIC	No	Tema separado para las respuestas (por defecto usa NTFY_TOPIC)
NTFY_MARKDOWN	No	Pon true para enviar respuestas con X-Markdown: true
NTFY_ALLOWED_USERS	Recomendada	Lista de nombres de tema separados por comas que se tratan como IDs de usuario
NTFY_ALLOW_ALL_USERS	No	Permitir a cualquier publicador — solo seguro para temas privados
NTFY_HOME_CHANNEL	No	Tema por defecto para cron / notificaciones
NTFY_HOME_CHANNEL_NAME	No	Etiqueta legible para el canal principal

El modelo de identidad: Léelo antes de desplegar

Aquí está el detalle de ntfy: no tiene cuentas de usuario reales. El campo title de un mensaje está controlado por el publicador — cualquiera puede suplantarlo. Por eso Hermes no usa title para la autorización.

En su lugar, el nombre del tema en sí mismo es la identidad. Cada mensaje en el tema se trata como si viniera del mismo usuario lógico. NTFY_ALLOWED_USERS suele ser simplemente el nombre del tema en sí — una lista de permitidos con una sola entrada.

Implicación de seguridad: cualquiera que conozca tu tema puede hablar con tu agente. Para convertir esto en un límite de confianza real:

• Auto-aloja ntfy y protege el tema con Control de Acceso.
• Solo los clientes autorizados pueden publicar o suscribirse.

Un consejo práctico para el uso diario

Pon NTFY_MARKDOWN=true si quieres que las respuestas con formato (negritas, listas, bloques de código) se vean bien en la aplicación de ntfy. Hace que las respuestas largas del agente sean mucho más fáciles de escanear en la pantalla del teléfono.

Conclusión

ntfy le da a Hermes un canal de push increíblemente simple: suscríbete en tu teléfono, configura tres variables de entorno y ya estás operativo. Sin cuenta en la nube, sin servicios extra, sin curva de aprendizaje.

Último consejo: empieza con un tema único como hermes-<tunombre>-<año> — es prácticamente a prueba de colisiones en el servidor público. Luego, una vez que confíes en el flujo de trabajo, auto-aloja ntfy y añade control de acceso para un canal realmente privado. Tu agente ahora está a un zumbido de distancia.

---