Comando hermes setup — Referencia Completa y Ejemplos

Descripción General

hermes setup es el asistente de configuración interactivo de Hermes Agent. Ejecutarlo sin argumentos inicia el asistente completo, que vuelve a configurar mostrando tus valores actuales como predeterminados. También puedes apuntar a una sola sección pasando su nombre como argumento.

Uso

hermes setup [-h] [--non-interactive] [--reset] [--reconfigure] [--quick] [--portal]
             [{model,tts,terminal,gateway,tools,telemetry,agent}]

Secciones de Configuración

Ejecuta una sección específica en lugar del asistente completo:

Sección	Qué configura
`model`	Modelo predeterminado, proveedor y credenciales API
`tts`	Proveedor de texto a voz y ajustes de voz
`terminal`	Backend de terminal (local, docker, ssh, modal) y valores predeterminados
`gateway`	Plataformas de mensajería (Telegram, Discord, Slack, etc.)
`tools`	Qué toolsets están activos por defecto
`telemetry`	Analítica de uso y preferencias de telemetría
`agent`	Comportamiento del agente, máximas iteraciones y valores de sesión

hermes setup model
hermes setup gateway
hermes setup tools

Opciones

Opción	Descripción
`--non-interactive`	Modo no interactivo (usa valores predeterminados/variables de entorno)
`--reset`	Restablece la configuración a los valores predeterminados
`--reconfigure`	(Predeterminado en instalaciones existentes.) Vuelve a ejecutar el asistente completo mostrando los valores actuales como predeterminados. Se mantiene por compatibilidad: un `hermes setup` sin más ahora hace esto.
`--quick`	En instalaciones existentes: solo pregunta por los elementos que faltan o no están definidos, en lugar de ejecutar el asistente de reconfiguración completo
`--portal`	Configuración única de Nous Portal: inicia sesión con OAuth, elige un modelo Nous, establece Nous como proveedor de inferencia y opta por el Tool Gateway. Omite el resto del asistente.

Ejemplos

# Ejecutar el asistente completo (reconfigura mostrando los valores actuales)
hermes setup

# Configurar solo la sección de modelo
hermes setup model

# Configurar el gateway de mensajería
hermes setup gateway

# Restablecer todo a los valores predeterminados
hermes setup --reset

# Solo preguntar por elementos faltantes o sin definir
hermes setup --quick

# Configuración única de Nous Portal con OAuth
hermes setup --portal

# Configuración no interactiva para scripts/CI
hermes setup --non-interactive

Consejos

En instalaciones existentes, un hermes setup sin argumentos vuelve a ejecutar el asistente con tus valores actuales como predeterminados — es seguro ejecutarlo en cualquier momento.
Usa --quick para que solo te pregunte por los elementos que faltan o no están definidos.
Usa --non-interactive para configuraciones headless o con scripts, confiando en valores predeterminados y variables de entorno.
Después de la configuración, ejecuta hermes doctor para verificar que todo esté completo y funcione.
Para un solo cambio, hermes config set key value es más rápido que el asistente completo.