Configuração do Hermes Agent

Este guia descreve como configurar o Hermes Agent para usar a Aiberm como provedor de modelos. O Hermes Agent é um agente de IA de código aberto desenvolvido pela Nous Research que roda no terminal e se integra a plataformas de mensagens, incluindo Telegram, Discord, Slack, WhatsApp e Signal.

Como a Aiberm expõe uma API /v1 compatível com a OpenAI, ela pode ser registrada como um provedor personalizado no Hermes Agent sem instalar nenhum plugin nem modificar o código-fonte. Depois de configurada, uma única chave de API dá acesso a todos os modelos disponíveis na Aiberm, incluindo Claude, GPT, Gemini, DeepSeek, Kimi, MiniMax, GLM e Grok.

Pré-requisitos

Uma conta Aiberm (Cadastre-se)
Uma chave de API da Aiberm (Obtenha sua chave)
Hermes Agent instalado — consulte o guia oficial de instalação

Instalação rápida (Linux / macOS / WSL2):

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Configurar a Aiberm como provedor

O Hermes Agent armazena sua configuração em ~/.hermes/config.yaml. Abra o arquivo e adicione uma entrada aiberm na seção providers:.

Se você não se sente confortável com editores de linha de comando como o Vim, pode abrir o arquivo de configuração usando o editor integrado do seu sistema operacional:

macOS: Abra o Finder, pressione Shift + Command + G, digite ~/.hermes na caixa de diálogo que aparecer e pressione Return. Localize o arquivo config.yaml, clique com o botão direito e selecione Abrir com → TextEdit.

Windows: Abra o Explorador de Arquivos, digite %USERPROFILE%\.hermes na barra de endereço e pressione Enter. Clique com o botão direito em config.yaml e selecione Abrir com → Bloco de Notas.

Depois de editar, lembre-se de salvar o arquivo (Command + S no macOS, Ctrl + S no Windows) e, em seguida, prossiga para a etapa de reinicialização descrita abaixo.

model:
  default: claude-sonnet-4-6
  provider: aiberm

providers:
  aiberm:
    base_url: https://aiberm.com/v1
    api_key: sk-your-aiberm-api-key
    type: openai
    default_model: claude-sonnet-4-6
    models:
      # Claude
      - claude-opus-4-7
      - claude-opus-4-6
      - claude-opus-4-6-thinking
      - claude-opus-4-5-20251101
      - claude-opus-4-5-20251101-thinking
      - claude-sonnet-4-6
      - claude-sonnet-4-6-thinking
      - claude-sonnet-4-5-20250929
      - claude-sonnet-4-5-20250929-thinking
      - claude-haiku-4-5-20251001
      - claude-haiku-4-5-20251001-thinking
      # Claude (anthropic/ prefix)
      - anthropic/claude-opus-4.7
      - anthropic/claude-opus-4.6
      - anthropic/claude-opus-4.6:thinking
      - anthropic/claude-opus-4.5
      - anthropic/claude-opus-4.5:thinking
      - anthropic/claude-opus
      - anthropic/claude-sonnet-4.6
      - anthropic/claude-sonnet-4.6:thinking
      - anthropic/claude-sonnet-4.5
      - anthropic/claude-sonnet-4.5:thinking
      - anthropic/claude-sonnet
      - anthropic/claude-haiku-4.5
      - anthropic/claude-haiku-4.5:thinking
      # GPT / OpenAI
      - gpt-5.4
      - gpt-5.4-xhigh
      - gpt-5.4-mini
      - gpt-5.3-codex
      - gpt-5.3-codex-xhigh
      - gpt-5.2
      - gpt-5.2-chat-latest
      - gpt-5.2-codex
      - gpt-5.1
      - gpt-5.1-codex
      - gpt-5.1-codex-max
      - gpt-5
      - gpt-5-mini
      - gpt-5-nano
      - o3-mini
      - gpt-4.1
      - gpt-4.1-mini
      - gpt-4.1-nano
      - gpt-4o
      - gpt-4o-mini
      # GPT / OpenAI (openai/ prefix)
      - openai/gpt-5.4
      - openai/gpt-5.4-mini
      - openai/gpt-5.3-codex
      - openai/gpt-5.2
      - openai/gpt-5.2-chat
      - openai/gpt-5.2-codex
      - openai/gpt-5.1
      - openai/gpt-5.1-codex
      - openai/gpt-5.1-codex-max
      - openai/gpt-5
      - openai/gpt-5-codex
      - openai/gpt-5-mini
      - openai/gpt-5-nano
      - openai/gpt-4.1
      - openai/gpt-4.1-mini
      - openai/gpt-4.1-nano
      - openai/gpt-4o
      - openai/gpt-4o-mini
      - openai/o3-mini
      # Gemini
      - gemini-3.1-pro-preview
      - gemini-3.1-pro-preview-thinking
      - gemini-3.1-flash-lite-preview
      - gemini-3.1-flash-image-preview
      - gemini-3-pro-preview
      - gemini-3-pro-preview-thinking
      - gemini-3-pro-image-preview
      - gemini-3-flash-preview
      - gemini-2.5-pro
      - gemini-2.5-flash
      - gemini-2.5-flash-image
      # Gemini (google/ prefix)
      - google/gemini-3.1-pro
      - google/gemini-3.1-flash-lite
      - google/gemini-3-pro
      - google/gemini-3-pro-mcpmark
      - google/gemini-3-flash
      - google/gemini-2.5-pro
      - google/gemini-2.5-flash
      # DeepSeek
      - deepseek-v3.2
      - deepseek-v3.2-exp
      - deepseek-r1-0528
      - deepseek-ocr
      - deepseek/deepseek-v3.2
      - deepseek/deepseek-v3.2-exp
      - deepseek/deepseek-v3.2-exp-thinking
      - deepseek/deepseek-r1
      - deepseek/deepseek-r1-0528
      # Grok (xAI)
      - grok-code-fast-1
      - grok-4-1-fast-reasoning
      - grok-4-1-fast-non-reasoning
      - grok-4.20-beta-0309-reasoning
      - grok-4.20-beta-0309-non-reasoning
      - x-ai/grok-4.1-fast
      - x-ai/grok-code-fast-1
      # Kimi / Moonshot
      - Kimi-K2.6
      - kimi-k2.5-thinking
      - kimi-k2.5
      # MiniMax
      - MiniMax-M2.7
      - minimax-m2.5
      - minimax-m2.1
      - minimax/minimax-m2.7
      - minimax/minimax-m2.5
      - minimax/minimax-m2.1
      # GLM (Zhipu)
      - glm-5.1
      - glm-5
      - glm-5-turbo
      # Qwen (Alibaba)
      - qwen3.6-plus
      - qwen3.5-plus
      - qwen3.5-397b-a17b
      # MiMo (Xiaomi)
      - mimo-v2-pro
      - mimo-v2-omni
      - mimo-v2-flash
      - xiaomi/mimo-v2-flash

Dica: A lista acima cobre a maioria dos modelos que a Aiberm oferece atualmente, o que é bastante extenso. Recomendamos manter apenas os modelos que você realmente usa e remover o restante.

Referência dos campos

Campo	Obrigatório	Descrição
`base_url`	Sim	Endpoint compatível com a OpenAI da Aiberm. Defina como `https://aiberm.com/v1`.
`api_key`	Sim	Sua chave de API da Aiberm, disponível no console.
`type`	Sim	Tipo de protocolo. Defina como `openai` — a Aiberm está em conformidade com a especificação OpenAI Chat Completions.
`default_model`	Sim	O modelo usado quando nenhum modelo explícito é especificado.
`models`	Recomendado	A lista de modelos exibida no seletor `/model`. O Hermes mostra apenas as entradas presentes nesta lista (mais `default_model`). Se for omitida, o seletor exibe um único botão.

A seção de nível superior model: designa o provedor ativo e o modelo padrão. Se você estava usando outro provedor, defina provider: como aiberm e defina default: como qualquer modelo listado no bloco models:.

Uso

Após atualizar a configuração, reinicie o Hermes (CLI: saia e execute novamente hermes; gateway: hermes gateway restart).

No terminal (CLI):

/model

O Hermes abre um seletor interativo de modelos. Selecione Aiberm e, em seguida, escolha o modelo desejado. Você também pode trocar diretamente:

/model claude-opus-4-7
/model gpt-5.4 --global

Adicionar --global persiste a alteração em config.yaml; omiti-lo aplica a alteração apenas à sessão atual.

No Telegram, Discord, Slack ou WhatsApp:

Envie /model para o seu bot. Ele retorna um teclado inline listando todos os provedores para os quais as credenciais estão configuradas. Selecione Aiberm para ver a lista paginada de modelos (8 por página, com navegação Prev / Next) e, em seguida, toque em um modelo para trocar.

Seletor /model do Telegram mostrando a lista paginada de modelos da Aiberm

Ver o catálogo completo de modelos

A lista models: acima é um subconjunto selecionado. Para ver todos os modelos atualmente servidos pela Aiberm, consulte a API diretamente:

curl -H "Authorization: Bearer sk-your-aiberm-api-key" \
     https://aiberm.com/v1/models | jq -r '.data[].id'

Adicione quaisquer IDs de modelo que você queira usar ao seu bloco models: e reinicie o Hermes. Eles aparecerão então no seletor /model.

Usar variáveis de ambiente (opcional)

Se preferir não armazenar a chave de API em config.yaml, você pode lê-la de uma variável de ambiente. Defina:

export AIBERM_API_KEY=sk-your-aiberm-api-key

Em seguida, referencie-a em config.yaml via key_env:

providers:
  aiberm:
    base_url: https://aiberm.com/v1
    key_env: AIBERM_API_KEY
    type: openai
    default_model: claude-sonnet-4-6

Solução de problemas

`/model` mostra apenas um único botão para a Aiberm

O bloco providers.aiberm está sem a lista models:. O seletor do Hermes só pagina quando mais de 8 modelos estão configurados. Adicione a lista selecionada mostrada acima e reinicie o Hermes.

401 Unauthorized

Verifique a chave de API no console da Aiberm.
Confirme se a chave está em providers.aiberm.api_key, e não no nível superior da configuração.

Modelo não encontrado

O catálogo de modelos da Aiberm evolui com o tempo; um modelo que você tinha listado pode ter sido renomeado ou descontinuado. Consulte /v1/models novamente (veja acima) e atualize sua lista models: de acordo.

Como verificar se a configuração foi carregada

hermes doctor

Este comando imprime um relatório de diagnóstico que inclui o provedor e o modelo atualmente ativos.