Skip to main content
Clientes e Ferramentas de Desenvolvedor

Hermes Agent

O Hermes Agent é uma ferramenta de codificação com IA para terminal que se conecta ao Alibaba Cloud Model Studio por meio dos planos Pay-as-you-go, Coding Plan, Token Plan (Personal Edition) ou Token Plan (Team Edition).

Instale o Hermes Agent

  1. Execute este comando para instalar o Hermes Agent. O script instala automaticamente dependências como Python e Git.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
O Windows não oferece suporte à instalação nativa. Instale o WSL2 primeiro e execute o comando acima no WSL2.
  1. Após a instalação, recarregue o ambiente do terminal.
source ~/.bashrc    # If using zsh, change to source ~/.zshrc
  1. Verifique a instalação. A exibição de um número de versão confirma o sucesso.
hermes --version

Configure credenciais de acesso

Execute hermes config set para configurar a Base URL e a API Key do plano escolhido:
  • Token Plan (Personal Edition): Assinatura pessoal que deduz créditos pessoais conforme o consumo de tokens.
  • Token Plan (Team Edition): Assinatura baseada em assentos; o consumo de tokens deduz créditos da equipe.
  • Coding Plan: Assinatura mensal fixa, mensurada pela quantidade de invocações de modelo.
  • Pay-as-you-go: Pós-pago com base no uso real.
Os exemplos neste tópico utilizam o protocolo compatível com Anthropic: a Base URL termina com /apps/anthropic e api_mode está definido como anthropic_messages. O Hermes Agent também suporta o protocolo compatível com OpenAI: substitua o sufixo /apps/anthropic na Base URL por /compatible-mode/v1 e remova a configuração api_mode. Por exemplo, a Base URL compatível com OpenAI para Pay-as-you-go (China North 2, Beijing) é https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1.Além da versão de linha de comando, o Hermes Agent oferece uma versão desktop (Hermes Desktop). Baixe o instalador no site do Hermes ou execute hermes desktop após instalar a versão de linha de comando. O Hermes Desktop e a versão de linha de comando compartilham o mesmo arquivo de configuração ~/.hermes/config.yaml, portanto os parâmetros de acesso são idênticos aos descritos aqui. Ao conectar-se por meio de um Custom Endpoint no aplicativo desktop, utilize a Base URL compatível com OpenAI descrita acima.

Token Plan (Personal Edition)

Substitua YOUR_API_KEY pela sua API Key do Token Plan (Personal Edition). Os modelos disponíveis estão listados em supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max-preview
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente: 
model:
  default: qwen3.8-max-preview
  provider: custom
  base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY
Modo de raciocínio do qwen3.8-max-preview:
  • thinking: Sempre ativado. Não pode ser desativado.
  • temperature: O padrão é 0,6 no modo de raciocínio. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
  • reasoning_effort: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.

Token Plan (Team Edition)

Substitua YOUR_API_KEY pela sua API Key do Token Plan (Team Edition). Os modelos disponíveis estão listados em supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.8-max-preview
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente: 
model:
  default: qwen3.8-max-preview
  provider: custom
  base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY
Modo de raciocínio do qwen3.8-max-preview:
  • thinking: Sempre ativado. Não pode ser desativado.
  • temperature: O padrão é 0,6 no modo de raciocínio. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
  • reasoning_effort: Controla a profundidade do raciocínio. Opções: xhigh, medium, low. Padrão: xhigh.

Coding Plan

Substitua YOUR_API_KEY pela sua API Key do Coding Plan. Os modelos disponíveis estão listados em supported models. 
hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-plus
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente: 
model:
  default: qwen3.7-plus
  provider: custom
  base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Pay-as-you-go

Substitua YOUR_API_KEY pela sua Alibaba Cloud Model Studio API Key. Os modelos disponíveis estão listados em Anthropic compatible API. Defina a base_url correspondente à sua região. A API Key deve corresponder à região selecionada. Substitua WorkspaceId pelo seu Workspace ID real.
  • China North 2 (Beijing): https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic
  • Singapore: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic.
hermes config set model.provider alibaba
hermes config set model.base_url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max
Esses comandos gravam as configurações em ~/.hermes/config.yaml. Você também pode editar o arquivo diretamente: 
model:
  default: qwen3.7-max
  provider: alibaba
  base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
  api_mode: anthropic_messages
  api_key: YOUR_API_KEY

Verifique a configuração

Envie uma mensagem de teste para validar sua configuração: 
hermes chat -q "Hello"
Uma resposta bem-sucedida confirma que a configuração funciona. Para alternar modelos, use o parâmetro -m: 
hermes chat -m qwen3.7-max

Perguntas frequentes

Códigos de erro

Em caso de erros de configuração, consulte as perguntas frequentes do seu plano de faturamento:
Começar
Faturamento
Plano de Tokens
Playground de Modelos
  • Music generation
Clientes e Ferramentas de Desenvolvedor
Inferência do Modelo
Ajuste fino
Implantação
Avaliação
Compressão de Modelos
Estatísticas e Monitoramento
Segurança e Conformidade
Melhores Práticas
Suporte
Registro de alterações