Comando hermes setup — Referência Completa e Exemplos

Visão Geral

hermes setup é o assistente de configuração interativo do Hermes Agent. Executado sem argumentos, ele inicia o assistente completo, que reexecuta a configuração mostrando seus valores atuais como padrão. Você também pode mirar uma única seção passando o nome dela como argumento.

Uso

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

Seções de Configuração

Execute uma seção específica em vez do assistente completo:

Seção	O que configura
`model`	Modelo padrão, provedor e credenciais de API
`tts`	Provedor de texto-para-fala e configurações de voz
`terminal`	Backend de terminal (local, docker, ssh, modal) e padrões
`gateway`	Plataformas de mensageria (Telegram, Discord, Slack, etc.)
`tools`	Quais toolsets estão ativos por padrão
`telemetry`	Analytics de uso e preferências de telemetria
`agent`	Comportamento do agente, iterações máximas e padrões de sessão

hermes setup model
hermes setup gateway
hermes setup tools

Opções

Opção	Descrição
`--non-interactive`	Modo não interativo (usa padrões/variáveis de ambiente)
`--reset`	Redefine a configuração para os padrões
`--reconfigure`	(Padrão em instalações existentes.) Reexecuta o assistente completo mostrando os valores atuais como padrão. Mantido por compatibilidade — um simples `hermes setup` agora faz isso.
`--quick`	Em instalações existentes: só pergunta sobre itens ausentes ou não definidos, em vez de executar o assistente de reconfiguração completo
`--portal`	Configuração única do Nous Portal: login via OAuth, escolha de um modelo Nous, definição do Nous como provedor de inferência e adesão ao Tool Gateway. Ignora o resto do assistente.

Exemplos

# Executar o assistente completo (reconfigura com os valores atuais como padrão)
hermes setup

# Configurar apenas a seção de modelo
hermes setup model

# Configurar o gateway de mensageria
hermes setup gateway

# Redefinir tudo para os padrões
hermes setup --reset

# Perguntar apenas sobre itens ausentes ou não definidos
hermes setup --quick

# Configuração única do Nous Portal com OAuth
hermes setup --portal

# Configuração não interativa para scripts/CI
hermes setup --non-interactive

Dicas

Em instalações existentes, um simples hermes setup reexecuta o assistente com seus valores atuais como padrão — é seguro reexecutar a qualquer momento.
Use --quick para ser perguntado apenas sobre itens ausentes ou não definidos.
Use --non-interactive para configurações headless ou scriptadas, contando com padrões e variáveis de ambiente.
Após o setup, execute hermes doctor para verificar se a configuração está completa e funcionando.
Para uma única mudança, hermes config set key value é mais rápido que o assistente completo.