Configure o Hermes
Conecte seu agente à ModelKiwi.
Instale e configure com um comando
Escolha o sistema e cole no terminal. As instruções são em inglês. A chave fica oculta; escolha um modelo autorizado e confirme a configuração. Claude, Gemini e OpenClaw usam uma ferramenta Node.js 22+. Hermes usa Python 3.9+ com PyYAML, sem Node.js. A instalação do cliente exige confirmação separada.
curl -fsSL https://www.modelkiwi.com/install/hermes.sh | bashirm https://www.modelkiwi.com/install/hermes.ps1 | iexcurl -fsSL https://www.modelkiwi.com/install/hermes.sh | bashDurante a instalação
- Crie uma chave com saldo e acesso ao modelo desejado.
- Execute o comando e aceite a instalação do ambiente/cliente, se necessário.
- Cole a chave, escolha o modelo e confirme a alteração. A versão anterior recebe um backup .bak-.
- Feche e reabra o cliente. Conversas reais consomem saldo.
Regras deste cliente
A referência configura Python/YAML. Reutilizamos Python 3.9+ com PyYAML do Hermes ou do ambiente ativo, sem Node. O instalador oficial Nous é opcional; --config-only nunca instala Hermes. Se faltar PyYAML, ative o ambiente Hermes ou crie um virtualenv com PyYAML. Respeitamos HERMES_HOME e HERMES_INSTALL_DIR.
Para configurar sem instalar o cliente, baixe o script e execute com --config-only. O ambiente da ferramenta continua necessário. Nenhuma conversa paga é iniciada automaticamente.
curl -fsSL https://www.modelkiwi.com/install/hermes.sh -o modelkiwi-setup.sh
bash modelkiwi-setup.sh --config-only$setup = irm https://www.modelkiwi.com/install/hermes.ps1
& ([ScriptBlock]::Create($setup)) --config-onlyO que será configurado
| Item | Valor |
|---|---|
| Arquivo | ~/.hermes/config.yaml + ~/.hermes/.env |
| API | https://api.modelkiwi.com/v1 |
| Protocolo | OpenAI Chat / Responses / Anthropic |
| Modelo | Selecionado da lista autorizada para sua chave. |
O instalador restringe as permissões dos arquivos e backups. Mescla os campos necessários, preservando outros provedores, skills e regras de aprovação. JSON/TOML/YAML são reformatados; o backup mantém o original.
Configuração manual e referência
Ver instalação e configuração manual
Instale pelo repositório oficial da Nous Research, sem depender de pacotes homônimos.
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashirm https://hermes-agent.nousresearch.com/install.ps1 | iexcurl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashmodel:
provider: modelkiwi
default: deepseek-v4-pro
base_url: https://api.modelkiwi.com/v1
api_mode: chat_completions
custom_providers:
- name: modelkiwi
base_url: https://api.modelkiwi.com/v1
api_mode: chat_completions
key_env: MODELKIWI_API_KEY
models: [deepseek-v4-pro]MODELKIWI_API_KEY="YOUR_MODELKIWI_API_KEY"Disponível em macOS, Linux e WSL; versões oficiais recentes também oferecem Windows nativo. Se hermes não aparecer no PATH após instalar, abra outro terminal e execute a configuração ModelKiwi.
Verificação e restauração
hermes --versionA consulta de versão não cobra uso. Faça uma conversa curta e confira os registros de uso. Em 401, verifique a chave; sem canal disponível, confira grupo/modelo; erros de protocolo ou ferramentas exigem conferir a compatibilidade do canal.
Para restaurar, feche o cliente, substitua o arquivo alterado pelo backup .bak- indicado e reinicie. Os backups podem conter chaves antigas; não publique os arquivos.