Hermes Agent + DeepSeek na rede Gonka: agente autônomo por centavos

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

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

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

Depois de instalar, reinicie o shell e confirme que ele abre:

source ~/.bashrc   # or ~/.zshrc
hermes             # interactive CLI

Chave de API da JoinGonka: se você ainda não tem uma, cadastre-se em gate.joingonka.ai/register, confirme seu endereço — você recebe 3M tokens grátis na conta — e crie uma chave com o prefixo jg- no Dashboard. Uma única chave e um único saldo funcionam para todos os modelos de uma vez.

O Hermes funciona com qualquer endpoint compatível com OpenAI: se o servidor responde a /v1/chat/completions, dá para apontar o Hermes para ele. O gateway da JoinGonka é exatamente assim. Existem três formas de configurar.

Forma 1: nosso instalador (um comando só, recomendado). Ele registra o provedor no config do Hermes, define o DeepSeek V4 Flash como modelo padrão e verifica com uma requisição ao vivo que o gateway aceita a chave e o modelo:

npx @joingonka/setup --tool hermes

Forma 2: assistente de configuração. Rode no terminal fora de uma sessão ativa:

hermes model

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

• API base URL: https://gate.joingonka.ai/v1
• API key: jg-your-key
• Model name: deepseek-ai/DeepSeek-V4-Flash-0731

Forma 3: editar o config. O Hermes guarda as configurações de modelos em ~/.hermes/config.yaml (na build nativa para Windows — %LOCALAPPDATA%\hermes\config.yaml) — é a única fonte de verdade. Adicione a seção:

# ~/.hermes/config.yaml
model:
  provider: custom
  default: deepseek-ai/DeepSeek-V4-Flash-0731
  base_url: https://gate.joingonka.ai/v1
  api_key: jg-your-key

O nome do modelo vai na chave default — é a chave canônica do Hermes. A linha model: dentro do bloco é só um alias reserva: não tem efeito se default já estiver definido (por exemplo, pelo assistente de configuração), então ao editar manualmente mude justamente default.

⚠️ A chave vai só em model.api_key. A documentação do Hermes permite OPENAI_API_KEY em ~/.hermes/.env, mas para endpoint personalizado isso não funciona: o Hermes lê a chave só de model.api_key, e com a chave no .env o gateway vai responder 401 Invalid API key. Testado no Hermes v0.20.4.

Verificação: rode 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 aparece com hermes config show | grep '^model\.' e hermes status.

Troca em tempo real: dentro da sessão com o comando /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. E /model custom sem nome puxa sozinho o modelo do endpoint, se houver só um lá.

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

Com o JoinGonka Gateway, o Hermes pode ser mantido em funcionamento 24 horas por dia: relatórios noturnos, auditorias semanais, tarefas em segundo plano via cron-scheduler, sem se preocupar com a conta. Com os preços da Anthropic, cada execução teria que ser calculada manualmente. O saldo inicial ao se registrar é suficiente para testar o agente em uma tarefa real e ver seu próprio consumo antes da primeira recarga.

Através do Gateway, o usuário tem acesso imediato a três modelos Gonka — todos eles suportam tool calling nativo (OpenAI function calling), portanto as habilidades e ferramentas do Hermes funcionam de forma confiável, sem a necessidade de fazer parsing 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 apenas para a duração da resposta. É melhor não definir nenhum dos dois: o Hermes determinará automaticamente os valores corretos fornecidos pelo provedor. Se definir max_tokens manualmente, mantenha-o dentro dos limites do modelo: através do Gateway, isso é 32768 para o DeepSeek V4 Flash e 8192 para o MiniMax M2.7 e GLM-5.3 Flash. Você pode trocar de modelo a qualquer momento com o comando hermes model ou diretamente na sessão através do /model.

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