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.

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

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

hermes model

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

• URL base da API: https://gate.joingonka.ai/v1
• Chave da API: jg-sua-chave
• Nome do modelo: Qwen/Qwen3-235B-A22B-Instruct-2507-FP8

Método 2: edição da configuração. Hermes armazena as configurações dos modelos em ~/.hermes/config.yaml — é a única fonte da verdade. Adicione a seção:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: Qwen/Qwen3-235B-A22B-Instruct-2507-FP8
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-sua-chave

Verificação: execute hermes e digite «Crie um arquivo hello.py com a função hello world». O agente deverá 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.

Troca em tempo real: dentro da sessão, com o comando /model custom:Qwen/Qwen3-235B-A22B-Instruct-2507-FP8. E /model custom sem nome puxará o modelo do endpoint automaticamente, se houver apenas um.

Hermes é uma ferramenta de agente com memória e habilidades. Ele não responde com uma única réplica: ele lê arquivos, escreve código, executa comandos, compacta o contexto, e gerencia tarefas de fundo longas através de um planejador. Cada ação é uma chamada de API, e em um dia de trabalho autônomo, dezenas de milhões de tokens se acumulam. Vamos comparar o custo de sessões típicas:

Com o JoinGonka Gateway, você pode manter o Hermes funcionando 24 horas por dia: relatórios noturnos, auditorias semanais, tarefas em segundo plano via planejador cron — sem se preocupar com a conta. Aos preços da Anthropic, cada execução teria que ser calculada manualmente. 10M de tokens gratuitos no registro serão suficientes para dezenas de sessões completas.

Através do Gateway, três modelos Gonka estão imediatamente disponíveis para o usuário — todos suportam tool calling nativo (chamada de função OpenAI), então as habilidades e ferramentas do Hermes funcionam de forma confiável, sem a análise de respostas de texto:

Sobre os limites de tokens no Hermes. No config.yaml, o campo context_length é a janela de contexto completa (entrada + saída), e max_tokens é o limite superior apenas para o comprimento da resposta. É melhor não definir ambos: o Hermes determinará os valores corretos do provedor. Se você definir max_tokens manualmente, mantenha-o dentro dos limites do modelo — para Qwen3-235B, o máximo via Gateway é 8192. Para alterar o modelo a qualquer momento, use o comando hermes model ou diretamente na sessão via /model.

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