Hermes Agent + Gonka AI — Agente autônomo por centavos

Instalação do Hermes (Linux, macOS, WSL2). O instalador oficial puxará Python, Node.js, ripgrep e ffmpeg automaticamente:

# Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# Windows (PowerShell)
iex (irm https://hermes-agent.nousresearch.com/install.ps1)

Após a instalação, reinicie o shell e verifique a execução:

source ~/.bashrc   # ou ~/.zshrc
hermes             # CLI interativo

Chave API JoinGonka: se ainda não tiver uma — registre-se em gate.joingonka.ai/register, obtenha 10M de tokens gratuitos e crie uma chave com o prefixo jg- no Dashboard. Uma única chave e um único saldo funcionam para todos os modelos.

O Hermes funciona com qualquer endpoint compatível com OpenAI: se o servidor responde a /v1/chat/completions, o Hermes pode ser direcionado para ele. O Gateway da JoinGonka é exatamente assim. Existem duas formas de configurar.

Método 1: assistente de configuração (recomendado). Execute no terminal fora de uma sessão ativa:

hermes model

Na lista de providers, escolha «Custom endpoint (self-hosted / VLLM / etc.)» e insira três valores:

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-sua-chave
• Model name: MiniMaxAI/MiniMax-M2.7

Método 2: edição do config. O Hermes armazena os ajustes de modelos em ~/.hermes/config.yaml — essa é a única fonte da verdade. Adicione a seção:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: MiniMaxAI/MiniMax-M2.7
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-sua-chave

Verificação: execute hermes e escreva «Crie um arquivo hello.py com uma função hello world». O agente deve criar o arquivo e mostrar o resultado. O estado da configuração atual pode ser visto via hermes config show | grep '^model\.' e hermes status.

Alternância em tempo real: dentro da sessão com o comando /model custom:MiniMaxAI/MiniMax-M2.7. E /model custom sem nome puxará o modelo do endpoint automaticamente caso haja apenas um.

Hermes — uma ferramenta de agente com memória e habilidades. Ele não responde com apenas uma réplica: lê arquivos, escreve código, executa comandos, comprime o contexto e conduz tarefas de fundo de longa duração através de um agendador. Cada ação é uma chamada de API e, em um dia de operação autônoma, dezenas de milhões de tokens são acumulados. Comparemos o custo de sessões típicas:

Com o JoinGonka Gateway, o Hermes pode ser mantido em execução 24 horas por dia: relatórios noturnos, auditorias semanais, tarefas de fundo via agendador cron — sem se preocupar com a fatura. Pelos preços da Anthropic, cada execução teria que ser calculada manualmente. 10M de tokens gratuitos no registro são suficientes para dezenas de sessões completas.

Através do Gateway, o usuário tem acesso imediato a dois modelos Gonka — ambos suportam tool calling nativo (OpenAI function calling), portanto, as habilidades e ferramentas do Hermes funcionam de forma confiável, sem a necessidade de processar respostas de texto:

Sobre os limites de tokens no Hermes. No config.yaml, o campo context_length é a janela de contexto total (entrada + saída), e max_tokens é o limite apenas para o tamanho da resposta. É recomendável não definir nenhum: o Hermes determinará os valores corretos fornecidos pelo provedor por conta própria. Se você definir o max_tokens manualmente, mantenha-o dentro dos limites do modelo — para ambos os modelos, o máximo via Gateway é 8192. Você pode trocar de modelo a qualquer momento com o comando hermes model ou diretamente na sessão através de /model.

Ferramentas de terminal similares em nossa base de conhecimento: Claude Code, Cline.