Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

Guía de despliegue de Hermes

Pensada para agentes de IA en terminal; abarca la instalación del entorno, la configuración del modelo y la solución de problemas.

Escenarios de uso: Hermes Agent es un agente de IA de terminal de código abierto creado por Nous Research. Resulta adecuado para quienes necesitan una línea de comandos local, lectura y escritura de archivos, herramientas web, de imagen y de voz, memoria persistente y una pasarela de mensajería. Este documento sigue el orden «instalar el entorno → instalar Hermes → configurar un modelo con Token de Guishu → iniciar el chat / la pasarela → solucionar problemas».

Elemento de configuraciónValor recomendadoDescripción
ProviderMore Provider / Custom / OpenAI CompatibleEl nombre varía ligeramente según la versión; elige la opción que permita introducir una URL personalizada.
Base URLhttps://api.llm-token.cn/v1Usa preferentemente la ruta raíz con /v1; si no funciona, prueba con https://api.llm-token.cn.
API Keysk-xxxxxxxxEs normal que el terminal no muestre el texto de la clave al pegarla.
Modelo recomendadoclaude-sonnet-4-6Responde con rapidez y es compatible con Agent, reconocimiento de imágenes y contextos amplios; también puedes elegir otro modelo de la lista.

I. Qué es Hermes

Hermes Agent permite conversar en el terminal, ejecutar comandos, leer y escribir archivos, buscar archivos, usar herramientas web y multimodales, y guardar preferencias a largo plazo mediante memoria persistente. Puedes verlo como un agente de IA capaz de trabajar de forma continua en un equipo local o en un servidor.

Recomendación para principiantes: configura primero correctamente el chat de línea de comandos y, después, continúa con canales de mensajería como Telegram, Discord o WeChat. Poner en marcha primero el flujo mínimo facilitará mucho la solución de problemas posteriores.

II. Elegir el método de instalación

SistemaMétodo recomendadoComando / descripción
Usuarios habituales de Windows / macOSHermes DesktopDescarga preferentemente el instalador de escritorio: es la opción más sencilla.
Linux / macOS / WSL2 / TermuxScript oficial de instalación con un solo comando
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
PowerShell nativo de WindowsScript oficial de PowerShell
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Opción estable para WindowsWSL2 + UbuntuSi la instalación nativa de Windows presenta problemas, utiliza WSL2.

III. Pasos de instalación en Windows con WSL2

  1. Abre PowerShell como administrador.
  2. Ejecuta el comando de instalación de WSL.
wsl --install

Si la instalación se queda bloqueada en el 0%, puedes usar este comando:

wsl --install --web-download -d Ubuntu
  1. Reinicia el equipo cuando se te indique.
  2. La primera vez que abras Ubuntu, configura el nombre de usuario y la contraseña de Linux.
  3. Pulsa la tecla Win y busca WSL o Ubuntu; si aparece un acceso, la instalación está disponible.

La imagen muestra el icono de Windows Subsystem for Linux (WSL), con un fondo rojo, un pingüino azul en la esquina superior izquierda y el texto blanco «Sistema WSL» a la derecha. Aparece después del paso «Pulsa la tecla Win y busca WSL o Ubuntu; si aparece un acceso, la instalación está disponible». Sirve como referencia visual para que el usuario confirme que WSL se ha instalado correctamente y complementa la operación de verificación descrita anteriormente.La imagen muestra el icono de Windows Subsystem for Linux (WSL), con un…

Comprueba que WSL se haya instalado correctamente:

wsl --version

IV. Instalar Git y Hermes

Ejecuta lo siguiente en el terminal de WSL2 / Ubuntu:

sudo apt update
sudo apt install git -y
git --version

A continuación, instala Hermes:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Cuando termine la instalación, vuelve a cargar la configuración del terminal y compruébala:

source ~/.bashrc
hermes version
hermes doctor

La imagen muestra el resultado de ejecutar el comando hermes --version en un terminal de WSL2/Ubuntu. Indica que la versión de Hermes Agent es v0.8.0, que se ejecuta el 8 de abril de 2026, que la ruta del proyecto es /home/omen/.hermes/hermes-agent, que la versión de Python es 3.11.15 y que la versión del SDK de OpenAI es 2.30.0; además, señala que ya está actualizado. La imagen corresponde a la sección «Instalar Git y Hermes» y muestra un ejemplo del paso de verificación posterior a la instalación de Hermes.La imagen muestra el resultado de ejecutar el comando hermes --version e…

Nota: hermes updata en la documentación antigua contiene un error ortográfico. El comando de actualización correcto es hermes update.

V. Configurar un modelo con Token de Guishu

  1. Ejecuta lo siguiente en el terminal donde instalaste Hermes:
hermes setup

La imagen muestra la interfaz del terminal en el que se ejecuta el comando de instalación de Hermes. El comando es «hermes setup» y, después de ejecutarlo, el terminal muestra el indicador «omen@LAPTOP-VMJ1GE8P:~», lo que indica que ha finalizado. La imagen corresponde al contenido «Ejecuta en el terminal donde instalaste Hermes: $ hermes setup». Es la respuesta del terminal después de elegir la configuración rápida o la del modelo, seleccionar «More Provider» / proveedor personalizado y, después, OpenAI Compatible u otro protocolo que permita introducir una URL personalizada.La imagen muestra la interfaz del terminal en el que se ejecuta el coman…

  1. Elige la configuración rápida o la configuración del modelo.
  2. Selecciona More Provider / proveedor personalizado.
  3. Selecciona OpenAI Compatible u otro protocolo que permita introducir una URL personalizada.

Esta imagen muestra la interfaz de operación del terminal al configurar Hermes. Tiene un fondo oscuro y, en la parte superior, indica que el entorno actual es el terminal de hermes-chat. La interfaz ofrece instrucciones de configuración claras: la primera línea solicita elegir la plataforma de mensajería correspondiente, como Telegram o Discord, y debajo aparecen varias opciones, entre ellas una relacionada con «set up messaging one (recommended)». La interfaz corresponde a una fase de la configuración del modelo con Token de Guishu y guía al usuario para completar la configuración de mensajería dentro del proceso de despliegue de Hermes.Esta imagen muestra la interfaz de operación del terminal al configurar…

La imagen muestra la interfaz para elegir un proveedor en el terminal de instalación de Hermes. En la parte superior aparece «Select provider:» y debajo se enumeran varias opciones, como Nous Portal y OpenRouter. Una flecha verde señala «More providers...». La imagen corresponde a la sección «Configurar un modelo con Token de Guishu» y al paso «Selecciona More Provider / proveedor personalizado»; orienta al usuario para que elija un proveedor personalizado durante la instalación de Hermes.La imagen muestra la interfaz para elegir un proveedor en el terminal de…

La imagen muestra la interfaz para elegir un proveedor en el terminal de instalación de Hermes. En la parte superior aparece «Select provider:» y debajo se enumeran distintas opciones, como GitHub Copilot ACP y Google AI Studio. Una flecha verde resalta «Custom endpoint (enter URL manually)», que permite introducir una URL manualmente. La imagen corresponde al paso de selección de proveedor personalizado dentro de la configuración del modelo con Token de Guishu. El usuario puede elegir el proveedor que necesite o introducir manualmente la URL de uno personalizado.La imagen muestra la interfaz para elegir un proveedor en el terminal de…

Al introducir la URL, usa preferentemente:

https://api.llm-token.cn/v1

Si la validación falla en la versión actual, prueba con:

https://api.llm-token.cn

La imagen muestra la página de configuración de una API personalizada compatible con OpenAI durante la configuración de un modelo con Token de Guishu en Hermes. El elemento principal es el texto «Custom OpenAI-compatible endpoint configuration». El campo configurado es API base URL, con el formato de ejemplo https://api.example.com/v1; la dirección personalizada introducida actualmente es https://api.llm-token.cn/v1. Esta página aparece después de elegir un proveedor personalizado y el protocolo compatible con OpenAI, y permite completar la configuración básica de la API correspondiente.La imagen muestra la página de configuración de una API personalizada co…

  1. Pega la API Key. Es normal que el terminal no muestre el texto de la clave; pulsa Intro después de pegarla.
  2. Para la primera prueba, se recomienda elegir el modelo claude-sonnet-4-6.
  3. Si se solicita la longitud del contexto, puedes introducir un contexto amplio al usar claude-sonnet-4-6. Si el cliente aplica un límite estricto, usa primero 32000 para ponerlo en marcha y aumenta el valor gradualmente.
  4. Puedes omitir el canal de chat la primera vez y configurar la pasarela cuando el chat del terminal ya funcione.

La imagen muestra la interfaz del terminal después de configurar un modelo con Token de Guishu en Hermes. En la parte superior aparece la API base URL https://api.example.com/v1, una API key opcional y la confirmación de que el endpoint se ha validado. Debajo se enumeran 33 modelos disponibles, entre ellos claude-sonnet-4-6 y claude-sonnet-4-6-thinking. En la parte inferior se solicita elegir un modelo y cada número corresponde a un nombre: por ejemplo, 1 es claude-sonnet-4-6 y 33 es glm-4.6v. La imagen corresponde al contexto posterior a la configuración del modelo y muestra la pantalla de selección.La imagen muestra la interfaz del terminal después de configurar un mode…

La imagen muestra la interfaz previa al inicio del chat una vez configurado Hermes. Aparece el mensaje «Connect a messaging platform? (Telegram, Discord, etc.)» y dos opciones: «Set up messaging now (recommended)» y «Skip — set up later with 'hermes setup gateway'». La opción seleccionada es «Skip» y una flecha la señala. La imagen está estrechamente relacionada con el contexto, que indica que, tras completar la configuración, se puede entrar directamente en el chat. Muestra la elección de conexión de plataforma antes de entrar, para que el usuario decida si quiere configurarla ahora o más tarde.La imagen muestra la interfaz previa al inicio del chat una vez configur…

VI. Iniciar el chat y la pasarela

Una vez completada la configuración, puedes entrar directamente en el chat. Si la interfaz pregunta si quieres iniciarlo, introduce Y.

La imagen muestra el mensaje del terminal después de completar el despliegue de Hermes. En la parte superior aparece «Ready to go!» y debajo se enumeran tres comandos con su función: «hermes» para iniciar el chat, «hermes gateway» para iniciar los canales de mensajería y «hermes doctor» para comprobar si hay problemas. En la parte inferior aparece «Launch hermes chat now? [Y/n]:», que pregunta si se desea iniciar inmediatamente el chat de Hermes y espera una respuesta Y/n. La imagen está relacionada con la sección «VII. Referencia rápida de comandos habituales» de la guía de despliegue de Hermes y muestra claramente los comandos disponibles tras el despliegue y sus funciones.La imagen muestra el mensaje del terminal después de completar el despli…

Si configuraste un canal de mensajería pero no responde, inicia o comprueba la pasarela:

hermes gateway
hermes gateway status

VII. Referencia rápida de comandos habituales

ComandoUso
hermesInicia el chat.
hermes setupAbre de nuevo el asistente de configuración completo.
hermes modelCambia de modelo o proveedor.
hermes doctorDiagnostica las dependencias, la configuración y el estado de los servicios.
hermes updateActualiza Hermes.
hermes --continueReanuda la sesión anterior.

VIII. Problemas habituales

ProblemaSolución
hermes: command not foundEjecuta source ~/.bashrc o vuelve a abrir el terminal. Si sigue sin funcionar, comprueba la variable PATH.
Falla la validación del modeloComprueba la URL, la API Key y el ID del modelo. Usa preferentemente https://api.llm-token.cn/v1.
Las respuestas se cortan o el contexto es demasiado pequeñoVuelve a hermes setup o ajusta context length en el archivo de configuración. Ponlo en marcha primero y amplía después el contexto.
WSL2 no puede acceder a un servicio local de WindowsEn Windows 11 puedes probar mirrored networking de WSL; en Windows 10 puedes sustituir localhost por la IP de la pasarela predeterminada de WSL.
La configuración desaparece tras una actualizaciónEjecuta hermes config check y hermes config migrate.
[wsl2]
networkingMode=mirrored
wsl --shutdown

Guía de despliegue de Codex

Explica la instalación de la herramienta CLI, la conexión con la API y la configuración del entorno de desarrollo.

Guía de configuración del modelo de generación de imágenes gpt-image-2

Tutorial de generación de imágenes para conectar Cherry Studio, paquetes de habilidades y scripts.

Secciones de esta página

I. Qué es HermesII. Elegir el método de instalaciónIII. Pasos de instalación en Windows con WSL2IV. Instalar Git y HermesV. Configurar un modelo con Token de GuishuVI. Iniciar el chat y la pasarelaVII. Referencia rápida de comandos habitualesVIII. Problemas habituales