ai2saveai2save

Hermes Agent Tutorial de Configuração

Os modelos, fornecedores e endpoints personalizados do Hermes Agent estão armazenados em ~/.hermes/config.yaml; informações sensíveis como API Key estão armazenadas em ~/.hermes/.env. O ai2save utiliza a interface OpenAI Compatible, e Base URL é https://ai2save.com/v1.

1. Criar API Key

  1. Abra https://ai2save.com/keys.
  2. Crie a chave e selecione o grupo que inclui o modelo desejado.
  3. Copie a Key completa do sk-....
  4. Anote o ID real do modelo exibido no console, por exemplo, gpt-5.5.

2. Recomenda-se usar o assistente interno

Execute no terminal:

hermes model

Selecione conforme as instruções:

Custom endpoint (self-hosted / vLLM / etc.)

Digite na ordem:

API base URL: https://ai2save.com/v1
API key: sk-sua-chave-api
Model name: gpt-5.5

O guia irá escrever esses valores em ~/.hermes/config.yaml. Não escreva Base URL em .env; a convenção oficial da Hermes é que a configuração do endpoint do modelo vem de config.yaml.

3. Editando manualmente o arquivo de configuração

Edite ~/.hermes/config.yaml:

model:
  provider: custom
  default: gpt-5.5
  base_url: https://ai2save.com/v1
  key_env: AI2SAVE_API_KEY

Descrição dos campos:

  • provider: custom: Use qualquer endpoint OpenAI Compatible.
  • default: ID do modelo padrão, deve coincidir exatamente com o ID do modelo disponível no console.
  • base_url: Deve vir acompanhado de /v1, Hermes fará solicitações de /chat/completions com base nisso.
  • key_env: Refere-se ao nome da variável de ambiente onde a chave é armazenada.

Editar ~/.hermes/.env:

AI2SAVE_API_KEY=sk-sua-chave-api

.env armazena informações sensíveis, config.yaml armazena configurações de modelo não sensíveis. Não envie .env para o Git.

4. Usando comandos de configuração para escrever

Você também pode usar os comandos integrados do Hermes, evitando erros de indentação YAML:

hermes config set model.provider custom
hermes config set model.default gpt-5.5
hermes config set model.base_url https://ai2save.com/v1
hermes config set model.key_env AI2SAVE_API_KEY
hermes config set AI2SAVE_API_KEY sk-sua-chave-api
hermes config check

AI2SAVE_API_KEY é o nome da variável de ambiente em maiúsculas, Hermes escreverá automaticamente em ~/.hermes/.env.

5. Reiniciar e verificar

  1. Saia completamente da sessão atual do Hermes ou Gateway.
  2. Reinicie o Hermes.
  3. Crie uma nova sessão e envie uma pergunta curta.
  4. Na sessão, digite /model para confirmar que o modelo atual é custom/gpt-5.5 ou gpt-5.5.

Uso temporário do modelo especificado:

hermes chat --provider custom --model gpt-5.5

Para a primeira verificação, recomenda-se desativar tarefas paralelas e ferramentas complexas, enviando apenas textos curtos. Após a autenticação e a conexão com o modelo, ative gradualmente ferramentas como terminal, web e arquivo.

6. Erros comuns

  • 401 / invalid_api_key: AI2SAVE_API_KEY não existe ou o valor está incompleto. Execute hermes config get model.key_env para verificar a referência.
  • 404 / model not found: model.default não é um ID de modelo real disponível no console.
  • Falha na conexão: base_url deve ser https://ai2save.com/v1; não escreva como https://ai2save.com.
  • Configuração não aplicada: o antigo OPENAI_BASE_URL afeta apenas openai-api Provider, e não será aplicado automaticamente em custom; verifique config.yaml em model.base_url.
  • Falha ao analisar YAML: não deve haver blocos model: duplicados; combine todos os campos em um único bloco.
  • Exceção na chamada de ferramenta: primeiro, confirme se o modelo suporta tool calling e use uma solicitação de texto curto para estabelecer a linha de base antes de ativar o conjunto de ferramentas.