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

Instalação do Hermes (Linux, macOS, WSL2). O instalador oficial baixará automaticamente 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)

Após a instalação, reinicie o seu shell e verifique se ele executa:

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

API-key do JoinGonka: se ainda não tiver uma, registre-se em gate.joingonka.ai/register, verifique seu endereço de e-mail — 3M de tokens gratuitos serão creditados em sua conta — e crie uma chave com o prefixo jg- no Dashboard. Uma chave e um saldo funcionam para todos os modelos imediatamente.

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 JoinGonka é exatamente assim. Existem três formas de configurar.

Método 1: nosso instalador (um comando, recomendado). Configura o provedor no arquivo de configuração do Hermes, define o DeepSeek V4 Flash como modelo padrão e verifica através de uma requisição ao vivo se o gateway aceita a chave e o modelo:

npx @joingonka/setup --tool hermes

Método 2: assistente de configuração. 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:

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

Método 3: edição do arquivo de configuração. O Hermes armazena as configurações de modelos em ~/.hermes/config.yaml, que é a única fonte da verdade. Adicione a seção:

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

⚠️ A chave deve ficar apenas em model.api_key. A documentação do Hermes permite OPENAI_API_KEY em ~/.hermes/.env, mas para um endpoint customizado isso não funciona: o Hermes lê a chave apenas de model.api_key, e se você usar a chave no arquivo .env, o gateway responderá com 401 Invalid API key. Testado no Hermes v0.20.4.

Verificação: inicie o 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 através de hermes config show | grep '^model\.' e hermes status.

Alternância imediata: dentro da sessão, use o comando /model custom:deepseek-ai/DeepSeek-V4-Flash-0731. Já /model custom sem nome selecionará automaticamente o modelo do endpoint, caso haja apenas um.

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.