Instalación de Hermes Agent
Hermes Agent es compatible con los siguientes sistemas operativos:
| Plataforma | Método de soporte |
|---|---|
| macOS | Aplicación de escritorio (recomendada) / Instalación por línea de comandos |
| Windows | Aplicación de escritorio (recomendada) / Script de PowerShell / WSL2 |
| Linux | Instalación por línea de comandos con un solo comando |
| Android (Termux) | Instalación por línea de comandos) |
Configuración del sistema:
| Elemento | Requisito mínimo | Configuración recomendada |
|---|---|---|
| Sistema operativo | Linux / macOS / WSL2 | Ubuntu 22.04+ / macOS 14+ / WSL2 (Ubuntu) |
| Python | 3.10+ | 3.11 o 3.12 |
| Memoria | 4 GB | 8 GB+ |
| Espacio en disco | 2 GB | 5 GB+ (reservado para caché de modelos y registros) |
| Red | Acceso a la API de LLM | Conexión estable a Internet |
Los usuarios de Windows deben usar WSL2 (Subsistema de Windows para Linux); Hermes Agent actualmente no es compatible de forma nativa con la línea de comandos de Windows.
Selección del método de instalación
Método 1: Hermes Desktop (recomendado para macOS / Windows)
Hermes Desktop es la aplicación de escritorio oficial, que ofrece una interfaz gráfica sobre la herramienta de línea de comandos: incluye Dashboard visual, administrador de perfiles, explorador de habilidades, etc. Al instalar la aplicación de escritorio, también se instala la herramienta de línea de comandos (hermescomando), y ambos se pueden usar juntos.
Descarga e instalación
- Visita el sitio web oficialhermes-agent.nousresearch.com
- Haz clic enDownload For...botón
- Ejecuta el instalador descargado y sigue las indicaciones para completar la instalación.

Una vez descargado, haz doble clic para instalar:

Una vez completada la instalación,hermesel comando se añadirá automáticamente a la ruta del sistema y se puede usar directamente en la terminal.
El panel completo se muestra a continuación:

Método 2: Instalación por línea de comandos (Linux / macOS / WSL2)
Abre la terminal y ejecuta el siguiente comando para completar la instalación automáticamente:
curl -fsSL https://get.hermes-agent.nousresearch.com | bash
Windows (PowerShell nativo):
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
El script detectará automáticamente el entorno del sistema e instalará todas las dependencias.
El comando anterior completará automáticamente todos los siguientes pasos:
- Detectar e instalar las dependencias faltantes (uv, Python 3.11, Node.js v22, ripgrep, ffmpeg)
- Clonar el repositorio de Hermes Agent en
~/.hermes/hermes-agent/ - Crear un entorno virtual de Python aislado
- Configurar globalmente
hermescomando - Guiarte para completar la configuración del proveedor de LLM

Instrucciones para el sistema Windows: No es compatible con el entorno Windows nativo. Instala primero WSL2 y luego ejecuta el comando anterior en la terminal de WSL2.
Si has instalado OpenClaw, también puedes importar la configuración directamente:

Aquí elige no importar e ingresan, entra en la configuración del modelo y selecciona la primera configuración rápida:

A continuación, seleccionamos More providers, que es el penúltimo elemento:

Aquí puedes elegir más grandes modelos nacionales o internacionales:

A continuación, usamosByteDance Ark Coding Plan, por lo que elegimosCustomer endpoint, es decir, una dirección de API personalizada y la API key.
Configuración de Base URL para la herramienta ByteDance Ark compatible con el protocolo de interfaz de OpenAI:https://ark.cn-beijing.volces.com/api/coding/v3
Configura la API key y los grandes modelos compatibles, por ejemploark-code-latest。
Una vez completada la instalación, actualiza el Shell:
source ~/.bashrc # Bash 用户 # o source ~/.zshrc # Zsh 用户
Verifica que la instalación se realizó correctamente:
hermes --version
Usa el siguiente comando para iniciar una conversación con el agente:
hermes

Explicación de la ubicación de instalación de archivos:
| Método de instalación | Ubicación del código | hermesComando |
Directorio de datos |
|---|---|---|---|
| pip install | Python site-packages | ~/.local/bin/hermes |
~/.hermes/ |
| Script de instalación de git (a nivel de usuario) | ~/.hermes/hermes-agent/ |
~/.local/bin/hermes(enlace simbólico) |
~/.hermes/ |
| Modo root (instalación con sudo) | /usr/local/lib/hermes-agent/ |
/usr/local/bin/hermes |
/root/.hermes/ |
Otras extensionesDocumentación de referencia:hermes-agent.nousresearch.com/docs/getting-started