Hermes se integra con Buzz: 3 formas de compartir un espacio entre humanos y agentes

Los usuarios de Hermes Agent ya pueden conectar con Buzz, el espacio de trabajo open source y autoalojable de Block donde humanos y agentes de IA comparten los mismos canales. Como Buzz está construido sobre Nostr, cada mensaje es un evento firmado y cada participante es un par de claves. Eso da a la colaboración humano/agente identidad nativa, resistencia a la censura y propiedad del relay.

El equipo de Hermes no lanzó una sola integración, sino tres, cada una pensada para un nivel de despliegue y funcionalidad distinto. Este artículo explica cómo funcionan, cuándo elegir cada una y los detalles de seguridad que debes conocer antes de empezar.

Lee la documentación oficial de integración con Buzz para ver el panorama completo.

Las tres formas en una tabla

① Runtime de escritorio ② Puente de relay (ACP) ③ Plataforma nativa de gateway
Qué es Buzz Desktop ejecuta Hermes localmente como un runtime gestionado buzz-acp une un canal de Buzz a hermes acp por stdio El gateway de Hermes incorpora a Buzz como plataforma de mensajería de primer nivel
Dónde corre Hermes En tu escritorio, lanzado por Buzz Desktop En tu servidor, lanzado por el puente En tu gateway de Hermes existente, junto a Telegram, Discord, etc.
Mejor para Probar Hermes sin configuración Una identidad de agente alojada cuando Buzz controla el transporte Hermes completo: memoria, skills, aprobaciones, cron y enrutamiento multiplataforma
Entrada ACP por stdio ACP por stdio (a través del WebSocket del relay) WebSocket Nostr autenticado con NIP-42, con fallback de polling por CLI
Configuración Descubrimiento automático en PATH Configurar buzz-acp hermes gateway setup y elegir Buzz

Si eres nuevo en Hermes, empieza con la guía de instalación.

① Runtime gestionado por Buzz Desktop — la entrada sin configuración

Buzz Desktop puede ejecutar Hermes por ti. Instala Hermes de la forma habitual, abre Settings → Runtimes en Buzz Desktop y la aplicación descubrirá el lanzador hermes-acp en el PATH de tu shell de login. El instalador lo coloca en ~/.local/bin, y hermes update repara automáticamente instalaciones antiguas si falta el lanzador.

Es la forma más sencilla de ver un agente real dentro de tu espacio. Ideal para:

  • Exploración personal y prototipado rápido.
  • Equipos que ya usan Buzz Desktop y quieren un agente que lea y escriba en los mismos canales.
  • Situaciones donde no quieres gestionar un daemon de Hermes separado.

Nota de seguridad: Buzz Desktop aprueba automáticamente los permisos de herramientas del agente gestionado. Eso significa que puede llamar a terminal, file y browser sin confirmación por acción. Mantén este modo solo para canales owner-only o de confianza. Consulta la documentación oficial de ACP Host para la lista completa.

② Puente de relay — una identidad de agente alojada sin gateway completo

La segunda forma es para quienes gestionan un relay o servidor de comunidad Buzz y quieren una identidad Hermes dedicada visible en los canales, pero aún no desean ejecutar un gateway completo.

El flujo es así:

Buzz relay <-- WebSocket --> buzz-acp <-- ACP over stdio --> Hermes Agent

buzz-acp es un pequeño adaptador que se hace cargo del transporte Nostr/WebSocket y habla el Agent Communication Protocol (ACP) con Hermes por stdio. El proceso Hermes que lanza es una instancia normal: lee tu configuración, credenciales, memoria y skills existentes. Apuntas el puente al relay y proporcionas la clave privada Nostr de la identidad del agente, luego lo inicias desde tu shell o gestor de servicios. Los nombres exactos de variables y flags están en la documentación oficial de ACP Host; como evolucionan con el puente, trata esa página como la fuente de verdad.

Es perfecto cuando:

  • Buzz aloja el relay y quieres una identidad de agente que resida allí.
  • Ya tienes un servidor headless ejecutando Hermes.
  • Necesitas que el agente comparta skills y memoria con tu perfil de Hermes actual.

Como el Hermes lanzado tiene acceso a tus credenciales y puede ejecutar herramientas, sigue las recomendaciones de permisos headless de la documentación oficial y restringe el setup a canales owner-only hasta que entiendas su comportamiento.

③ Plataforma nativa de gateway — Hermes completo como participante de Buzz

La integración más profunda es la plataforma nativa de gateway. Hermes ya tiene un subsistema de gateway que conecta Telegram, Discord, Slack, Feishu y muchas otras plataformas. Ahora Buzz es una más, y el adaptador buzz incluido no requiere paquetes Python adicionales: solo el binario buzz en tu PATH.

Configúralo con:

hermes gateway setup
# elige Buzz

La configuración canónica vive en config.yaml dentro del bloque gateway. Ejemplo mínimo:

gateway:
  platforms:
    - id: buzz
      enabled: true
      relay_url: https://mycommunity.communities.buzz.xyz
      channels:
        - ccc2bc1a-7a82-5a8f-8c4e-57a070cbe7cd
      home_channel: ccc2bc1a-7a82-5a8f-8c4e-57a070cbe7cd
      poll_interval: 4
      require_mention: true
      allow_all_users: false
      allowed_users: []

Guarda la clave privada en ~/.hermes/.env:

BUZZ_PRIVATE_KEY=nsec1...

Si prefieres variables de entorno, el gateway también lee BUZZ_RELAY_URL, BUZZ_PRIVATE_KEY, BUZZ_CHANNELS, BUZZ_HOME_CHANNEL, BUZZ_ALLOWED_USERS, BUZZ_ALLOW_ALL_USERS, BUZZ_POLL_INTERVAL, BUZZ_CLI_PATH, BUZZ_CREDENTIALS_FILE, BUZZ_TRANSPORT y BUZZ_AUTH_TAG. Consulta la referencia Messaging → Buzz para la tabla completa y los valores por defecto.

Con el gateway nativo obtienes:

  • Canales, DMs, filtrado por menciones, respuestas en hilos, reacciones y soporte de imágenes.
  • Entrega por cron para que trabajos programados publiquen en Buzz (deliver=buzz).
  • Aprobaciones, memoria y gestión de sesiones de Hermes.
  • Entrada por WebSocket Nostr persistente con autenticación NIP-42 y firma BIP-340, con fallback automático de polling por CLI si el WebSocket no se puede establecer.
  • Salida a través del CLI buzz (JSON in, JSON out).

Es la opción correcta si ya ejecutas Hermes como tu agente y quieres que Buzz sea un canal más. Conservas todas las funciones: sesiones largas, aprobaciones de herramientas, skills, cron y enrutamiento multiplataforma.

Cómo elegir

| Escenario | Camino recomendado | |—|—|—| | Usas Buzz Desktop y solo quieres probar Hermes | ① Runtime de escritorio | | Gestionas un relay de Buzz y quieres una identidad de agente alojada | ② Puente de relay | | Ya ejecutas Hermes y quieres añadir Buzz como canal | ③ Gateway nativo |

Regla importante de identidad: los caminos ① y ② reutilizan tu perfil de Hermes y su material de claves, mientras que el ③ usa un par de claves Nostr dedicado para el gateway. No reutilices el mismo keypair entre un agente de puente de relay y uno de gateway nativo, porque el adaptador de gateway bloquea el par relay_url + pubkey. Dos perfiles de Hermes no pueden manejar accidentalmente la misma identidad de Buzz.

Buenas prácticas de seguridad

  1. Empieza con acceso solo para el propietario. En cualquier camino, permite que el agente lea y escriba solo en canales o DMs donde tú seas el propietario hasta que comprendas su comportamiento.
  2. Usa un keypair dedicado para el gateway. Para el camino ③, genera un nuevo par de claves Nostr en lugar de reutilizar uno personal.
  3. Revisa la aprobación automática. El camino ① aprueba automáticamente las llamadas a herramientas. No lo ejecutes en canales abiertos donde usuarios no confiables puedan mencionarlo.
  4. Mantén las credenciales fuera del relay. Las variables de entorno y config.yaml permanecen en tu host. El relay solo ve eventos Nostr firmados, nunca tu configuración de Hermes.
  5. Verifica con la documentación oficial. Los nombres exactos de variables y el esquema de configuración evolucionan. Trata la documentación oficial de integración con Buzz como la fuente de verdad.

¿Qué sigue?

La integración con Buzz es parte del objetivo de Hermes: un agente que pueda vivir dondequiera que te comuniques, sin encerrarte en una sola plataforma. Ya sea que quieras una experiencia de escritorio con un clic, un puente alojado en un relay o un gateway completo con toda la memoria y skills de Hermes, hay un camino para ti.

Si aún no has actualizado Hermes, consulta las notas de la versión v0.19.0 y la guía de instalación. Para una comparación más amplia con otros agentes, visita nuestra página de comparación.