Cómo instalar Hermes Agent en Saplo (agente de IA para comunicadores)

Antes de empezar, una cosa de inmediato: Hermes Agent no tiene un panel web. No hay pantalla de inicio de sesión, no hay panel de control con gráficos, no hay nada que se muestre en el navegador al ingresar al dominio. Toda la configuración, desde la clave del modelo de lenguaje hasta la conexión del bot a Telegram, se realiza en la terminal. Si buscas un chatbot listo para usar con una interfaz de clic, esta no es la aplicación; en el Catálogo de aplicaciones de Saplo encontrarás otras herramientas más adecuadas. Hermes Agent es para otra persona: para un desarrollador o una agencia que quiere tener su propio agente de IA conectado a mensajería, sin escribir integraciones con la API del modelo desde cero y sin pagar una suscripción mensual por una plataforma SaaS que, de todos modos, hace lo mismo por dentro. Si esto describe tu situación, a continuación te explicamos paso a paso cómo instalar Hermes Agent en Saplo.

Para quién es Hermes Agent

Antes de instalar, comprueba si esta herramienta se ajusta realmente a lo que quieres hacer:

• Estás creando un bot que responderá por ti en Telegram, Discord o Slack - Hermes Agent se conecta al comunicador elegido y conversa con los usuarios en tu nombre, utilizando el modelo de lenguaje que tú indiques.
• No quieres escribir tu propia integración con la API del modelo - La gestión de webhooks, la cola de mensajes y el mantenimiento de la conexión con el comunicador ya están en la imagen Docker; tú solo proporcionas las claves.
• Prefieres pagar una vez por un Box que mensualmente por una plataforma SaaS - Hermes Agent es de código abierto, no tiene una suscripción aparte; pagas exclusivamente por el Box donde está alojado.
• No te importa la configuración a través de la terminal - Si esperas un asistente en el navegador, esta aplicación te decepcionará; aquí todo ocurre en SSH.

Si buscas un chatbot listo para la atención al cliente con un panel de administración, consulta otras opciones en el Catálogo de aplicaciones; allí encontrarás herramientas con interfaz web.

Requisitos

Para instalar Hermes Agent en Saplo, necesitas:

• Un Box en un plan L o superior, porque la configuración inicial requiere acceso SSH a través del Terminal Online, y los planes inferiores no lo tienen.
• Un mínimo de 1,5 GB de RAM libre y 8 GB de espacio en disco.
• Un dominio o subdominio *.saploapp.pl, incluido en el precio de cualquier plan, donde se alojará la página de información (Hermes es headless, así que bajo el dominio solo verás las instrucciones, no un panel).
• Una clave API para el modelo de lenguaje, que proporcionarás durante la configuración en el terminal, y un token de bot para el comunicador al que Hermes debe conectarse.
• NO necesitas una base de datos separada; toda la configuración y el historial de conversaciones se guardan en un volumen de Docker con nombre.

Instalación paso a paso

1. En el panel de Saplo, ve al Catálogo de aplicaciones y selecciona Hermes Agent (categoría "Aplicaciones AI").
2. Indica un Box en el plan L o superior con un mínimo de 1,5 GB de RAM libre y un dominio o subdominio donde se alojará la página de información.
3. Confirma la instalación. El motor instala Docker CE, si aún no está en el Box, descarga la imagen oficial nousresearch/hermes-agent (aproximadamente 900 MB) y ejecuta el contenedor sin un puerto HTTP expuesto, todo el tráfico permanece dentro del contenedor.
4. Después del inicio, el motor verifica si el contenedor realmente funciona y no ha entrado en un bucle de reinicios, en lugar de limitarse a docker compose up sin verificación.
5. Bajo el dominio indicado, aparece una página estática con instrucciones de configuración, ya que Hermes no expone su propia interfaz web.

Primera configuración

1. En el panel de Saplo, entra en el Terminal Online del Box donde está Hermes (requiere un plan Box L o superior).
2. Ejecuta el asistente de configuración con el comando docker exec -it hermes-<slug> hermes setup, donde <slug> es el nombre de tu instalación visible en el panel.
3. En el asistente interactivo, proporciona la clave API del modelo de lenguaje y el token del bot para el comunicador elegido (Telegram, Discord o Slack).
4. Una vez finalizado el asistente, el agente se conecta al comunicador automáticamente, sin necesidad de reiniciar el contenedor.
5. Puedes ver el estado de funcionamiento del agente en tiempo real con el comando docker logs -f hermes-<slug> en el mismo Terminal Online.

Hermes Agent en Saplo vs. otras alternativas

Preguntas frecuentes

¿Tiene Hermes Agent un panel web? No, la aplicación es headless. En el dominio que indiques durante la instalación, solo verás una página estática con las instrucciones de configuración; el agente en sí funciona en un contenedor Docker y no expone ninguna interfaz en el navegador.

¿Por qué la instalación requiere un plan Box L y no uno inferior? Porque la primera configuración se realiza a través del Terminal Online, es decir, acceso SSH al contenedor, y este solo está disponible a partir del plan Box L. En planes inferiores puedes desplegar el contenedor, pero no configurar el agente.

¿Qué modelo de lenguaje puede usar Hermes Agent? Proporcionas tu propia clave API durante la configuración en el asistente hermes setup, por lo que la elección del modelo depende del proveedor al que tengas acceso. Saplo no impone un proveedor específico ni añade cargos por las consultas al modelo.

¿Dónde se guarda el historial de conversaciones del agente? En un volumen Docker nombrado en tu Box; este mismo volumen sobrevive a la limpieza del catálogo de aplicaciones, por lo que la configuración y el historial no desaparecen con las operaciones normales en el Box.

¿Puedo conectar Hermes Agent a más de un comunicador a la vez? El asistente hermes setup te guía paso a paso por la configuración del comunicador, así que si quieres manejar más de un canal, ejecutas el asistente de nuevo y añades otra conexión en el mismo contenedor.

Si quieres tener tu propio agente de IA en Telegram, Discord o Slack sin escribir integraciones desde cero y sin una suscripción SaaS, y el terminal no te asusta, puedes instalar Hermes Agent en Saplo en unos minutos. Escríbenos si necesitas ayuda con la primera configuración.