Cómo instalar Hermes Agent en un VPS (guía paso a paso 2026)

Lo que necesitas saber:

• Hermes Agent es el agente de IA de código abierto y automejorable de Nous Research, diseñado para ejecutarse en una CLI y comunicarse contigo a través de aplicaciones de mensajería.
• Instálalo en cualquier hosting de Linux, macOS o WSL2 con Git y Python 3.11+. El instalador de una línea es el más rápido en un VPS.
• Un pequeño VPS con 1 vCPU y 1 GB de RAM es suficiente cuando el LLM se ejecuta a través de una API. Planifica 2 GB o más para herramientas locales o memoria. Un Cloud VPS 10 de Contabo es más que suficiente para empezar.
• Docker es compatible con un patrón de un contenedor por perfil, recomendado para producción.
• Conéctate a Telegram, Discord, Slack, WhatsApp, Signal o correo electrónico a través de la pasarela para que el agente siga siendo accesible fuera del terminal.
• Hermes Agent impulsa cualquier modelo de Hermes AI con una ventana de contexto de 64.000 tokens, incluyendo las familias Hermes 3 y Hermes 4.

Instalar Hermes Agent en un VPS te da un agente de IA automejorado que vive en tu servidor, recuerda el contexto a través de sesiones y es accesible a través de Telegram, Discord o Slack. Esta guía explica la instalación de extremo a extremo en un VPS nuevo de Contabo que ejecuta Ubuntu, cubriendo Docker, el asistente de configuración, un proveedor de LLM y una unidad systemd. Planee alrededor de 15 minutos desde una sesión SSH nueva hasta un agente en funcionamiento.

Antes de instalar: Hermes Agent en 60 segundos

Hermes Agent es el agente de IA autónomo de código abierto creado por Nous Research. Funciona como una interfaz de línea de comandos, expone un servidor API compatible con OpenAI y viene con herramientas integradas para acceso a terminal, operaciones de archivos, búsqueda en la web, memoria persistente y un bucle de mejora de habilidades automática.

¿Qué es Hermes Agent AI?

Hermes Agent AI es el término de Nous Research para el agente más su tiempo de ejecución completo: la CLI, la tienda de memoria, el sistema de habilidades y la pasarela que lo conecta con tus aplicaciones de mensajería. Tú aportas tu propio LLM; Hermes proporciona todo lo que convierte a ese LLM en un agente persistente y automejorado.

Lo que diferencia al agente Hermes AI de un envoltorio de chatbot es el ciclo de aprendizaje cerrado. Conserva y organiza su propia memoria, mantiene habilidades entre sesiones y construye un modelo de ti y de tu trabajo mediante el modelado de usuarios basado en Honcho. Cuanto más tiempo se ejecute en tu VPS, más útil será.

Requisitos del sistema de Hermes Agent en 2026

El framework de agentes IA de Hermes en sí mismo es ligero; el costo real de recursos es el LLM, el almacenamiento de memoria y cualquier herramienta local. Un pequeño VPS con 1 vCPU y 1 GB de RAM es suficiente para la ruta solo API. Para un LLM local con Ollama en el mismo servidor, planifica más RAM y, idealmente, una GPU.

El agente Hermes AI funciona con cualquier modelo que soporte una ventana de contexto de 64.000 tokens, incluyendo las familias Hermes 3 AI y Hermes 4 AI. Un Contabo Cloud VPS de nivel de entrada cubre la configuración solo API. Para un modelo local junto a él, puedes optar por un plan de gama alta con suficientes recursos para un modelo ligero de Ollama.

Paso 1: Prepara tu entorno VPS

Provisiona un VPS nuevo con Ubuntu, luego conéctate por SSH como usuario root y actualiza el sistema. La mayoría de los problemas de instalación provienen de un índice de paquetes obsoleto o una dependencia faltante.

Conéctate vía SSH y actualiza los paquetes

ssh root@your-vps-ip
apt update && apt upgrade -y
apt install -y git curl ca-certificates

Se requiere Git. curl y ca-certificates se encargan de gestionar el instalador y las conexiones HTTPS con tu proveedor de LLM. Se necesita Python 3.11+, pero el instalador hace el provisionamiento de un Python gestionado a través de uv. Si planeas usar la ruta Docker de Hermes Agent AI, sigue el Paso 2 en su lugar.

Crea un usuario no root y refuerza SSH

No ejecutes Hermes Agent como root. Crea un usuario sudo, luego cambia a él:

adduser hermes
usermod -aG sudo hermes
rsync --archive --chown=hermes:hermes ~/.ssh /home/hermes
su - hermes

Usa solo inicio de sesión SSH con clave, desactiva la autenticación por contraseña en <wpml_ignored_tag wpml_name=»code» wpml_value=»L2V0Yy9zc2gvc3NoZF9jb25maWc=» wpml_attrs=»»/>, y confirma que hay un firewall en su lugar. La higiene del servidor importa una vez que un agente autónomo de Hermes AI actúa en tu nombre.

Paso 2: Instalar Docker para Hermes Agent

Tienes dos rutas para la instalación de Hermes Agent en un VPS: nativa con el script de una línea, o un despliegue de Docker de Hermes Agent AI. Docker es el patrón recomendado para producción porque aísla al agente y hace que la gestión de perfiles sea más limpia.

Instala Docker Engine desde el repositorio oficial de apt:

1. Agrega la clave GPG de Docker y la fuente de apt.
2. Actualiza el índice de paquetes.
3. Instala docker-ce, docker-ce-cli, containerd.io y docker-compose-plugin.
4. Agrega tu usuario al grupo de docker: sudo usermod -aG docker $USER.
5. Cierra sesión y vuelve a iniciar sesión, luego confirma con docker --version.

Elige Docker para producción; el instalador nativo en el Paso 3 es más rápido para uso personal. Si tu Contabo VPS se envió con el complemento de Docker, este paso ya está hecho.

Paso 3: Desplegar Hermes Agent con el instalador oficial

Hermes Agent envía un instalador oficial de una línea mantenido por Nous Research. Provisiona Python a través de uv, instala Node.js, descarga dependencias y crea el comando CLI hermes. El código fuente vive en el repositorio de GitHub de Hermes.

Opción A: Instalador de curl de una línea (Nativo)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes --version

El primer comando instala el runtime de Hermes Agent AI de principio a fin, descargado del repositorio de Hermes en GitHub. La recarga de la fuente hace hermes disponible en la shell actual. Para omitir el asistente, pasa -s -- --skip-setup.

Opción B: Despliegue de Docker (Recomendado)

Para un despliegue de Docker de Hermes Agent AI, Nous Research recomienda un contenedor por perfil, no la función de perfil múltiple incorporada.

docker run -d \
  --name hermes-agent \
  --restart unless-stopped \
  -v hermes-data:/home/hermes/.hermes \
  -e HERMES_PROFILE=default \
  nousresearch/hermes-agent:latest

El volumen nombrado preserva la memoria, habilidades y credenciales entre recreaciones. Fija la etiqueta de imagen para producción.

Paso 4: Ejecuta el asistente de instalación y configura un proveedor LLM

Hermes Agent necesita un LLM detrás. El asistente de configuración maneja la selección de proveedores, la entrada de la clave de API y el modelo predeterminado:

hermes setup

El asistente pregunta por:

• Hermes Agent AI LLM: el modelo con el cual el agente razonará.
• Proveedor LLM: OpenRouter, MiniMax, Nous Portal, Anthropic, OpenAI, un punto final local de Ollama o cualquier proveedor compatible.
• Clave API: almacenada localmente bajo ~/.hermes.
• Modelo: debe soportar al menos una ventana de contexto de 64.000 tokens.
• Herramientas: alternar acceso al terminal, operaciones de archivos, búsqueda web y memoria.
• Nombre del perfil: útil al ejecutar múltiples perfiles en un solo host.

El agente de Hermes AI vuelve a leer su configuración al iniciarse, por lo que puedes volver a ejecutar cualquier sección con hermes setup model, hermes setup tools or hermes config set.

Paso 5: Verificar que Hermes Agent esté en funcionamiento

Antes de conectar una pasarela de mensajería, asegúrate de que el agente funciona correctamente:

hermes doctor
hermes --version
hermes

El comando doctor verifica dependencias, versión de Python, ventana de contexto del modelo y conectividad de la API. El tercer comando lo lleva a una sesión interactiva donde un rápido «hola» confirma el retorno de LLM. Corrige cualquier cosa hermes doctor que se marque antes de continuar.

Paso 6: Conecta una pasarela de mensajería (Telegram, Discord o Slack)

Un asistente de Hermes Agent AI solo vale la pena en un VPS si puedes alcanzarlo desde cualquier lugar. El gateway incorporado conecta el agente a Telegram, Discord, Slack, WhatsApp, Signal o correo electrónico.

Telegram es el punto de partida más común porque los bots de Telegram son los que se provisionan más rápido. El flujo general:

1. Crea un bot en la plataforma (Telegram BotFather, portal de desarrolladores de Discord, aplicación de Slack).
2. Copia el token del bot y cualquier ID requerido.
3. Agrégalos con hermes config set o tu archivo de entorno.
4. Inicia la pasarela con hermes gateway.
5. Envía un mensaje de prueba y confirma que Hermes responda.

Integración de Telegram con Hermes AI Agent

Para Telegram, la pasarela convierte a Hermes en un bot privado al que le envías un mensaje desde tu teléfono. Slack y Discord funcionan de la misma manera: el agente vive en un canal o DM y respeta los permisos que otorgas durante la configuración de la aplicación. Trata los tokens de bot como secretos de producción.

Paso 7: Ejecuta Hermes Agent como un servicio 24/7

Un VPS solo es útil si el agente permanece en línea después de reinicios. Para una instalación de Docker, la política de reinicio está haciendo el trabajo:

docker update --restart unless-stopped hermes-agent

Para una instalación nativa, registra Hermes como un servicio systemd:

# /etc/systemd/system/hermes.service
[Unit]
Description=Hermes Agent
After=network-online.target

[Service]
Type=simple
User=hermes
WorkingDirectory=/home/hermes
ExecStart=/home/hermes/.local/bin/hermes gateway
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Luego, habilítalo y arráncalo:

sudo systemctl daemon-reload
sudo systemctl enable --now hermes

Esta es la forma de systemd que hace que la automatización de Hermes Agent AI sea confiable a través de reinicios. Restart=always trae de vuelta al agente después de un choque; solo systemctl stop lo mantiene abajo a propósito.

Lista de verificación de instalación de Hermes Agent

Una auditoría rápida posterior a la instalación:

• VPS en un SO soportado (Linux o WSL2)
• Paquetes del sistema actualizados; git, curl, ca-certificates instalados
• Usuario no root creado; inicio de sesión solo con clave SSH
• Docker instalado (o se omitió para la instalación nativa)
• Hermes Agent instalado a través de script o imagen de Docker
• hermes --version devuelve la versión esperada
• Asistente de configuración completado con proveedor LLM, clave API y modelo
• El modelo elegido soporta una ventana de contexto de 64.000 tokens
• hermes doctor informa limpio y el agente Hermes AI respondió a una solicitud de prueba
• Al menos una pasarela de mensajería conectada y probada
• unidad systemd o política de reinicio de Docker en su lugar
• Volumen de memoria (~/.hermes) respaldado

Errores comunes de instalación de Hermes Agent a evitar

• Intentos de instalación nativos de Windows. Hermes Agent no se ejecuta en Windows nativo. Usa WSL2 o un VPS.
• Versión de Python incorrecta. El instalador requiere Python 3.11+ a través de uv. Python 3.10 o 3.9 del sistema causa errores de dependencia silenciosos.
• Modelos con ventanas de contexto demasiado pequeñas. Cualquier cosa por debajo de 64.000 tokens pierde contexto a mitad de tarea.
• Ejecutándose como root. Hermes tiene acceso al terminal como herramienta incorporada. Dale un usuario sin privilegios.
• Omitir hermes doctor. La mayoría de los problemas de instalación aparecen allí primero.
• Olvidar persistir ~/.hermes. Esto mantiene la memoria, habilidades y credenciales.
• Uso de la función de múltiples perfiles incorporada dentro de un contenedor Docker de Hermes Agent AI. Nous Research recomienda un contenedor por perfil.
• Dejando el gateway expuesto. Trata los tokens de bot y la clave API como secretos de producción.

Por qué Contabo VPS/VDS es una buena opción para Hermes Agent

Hermes Agent funciona cómodamente en hardware pequeño cuando el LLM se aloja, y escala de forma limpia para modelos locales. Un Cloud VPS básico maneja el camino solo de API al precio que la mayoría de los proveedores cobran por la mitad de los recursos. Para un LLM local junto al agente, un VPS o VDS de gama alta te da más recursos para manejar inferencias ligeras, o para cargas de trabajo de producción.

La portabilidad también es importante. El mismo instalador y la imagen Docker funcionan en todas las opciones de Contabo VPS, por lo que puedes empezar con algo pequeño y escalar más tarde. Lo mismo ocurre con el ecosistema más amplio de agentes de código abierto: si alguna vez quieres comparar una configuración de agente de IA de Hermes con alternativas como OpenClaw, puedes iniciar una al lado de ella en el mismo VPS sin cambiar de proveedor.

Puedes instalar fácilmente Hermes en un Contabo VPS con un clic desde tu Customer Control Panel. Simplemente reinstala el servidor seleccionando el Agente Hermes como la aplicación.

Preguntas frecuentes: instalar Hermes Agent en un VPS