Skip to main content
Visão geral da integração do Hermes Agent com a AIHubMix

​
Início rápido

​
Step 1: Instalar o Hermes

Abra o terminal e execute os seguintes comandos:

​
Linux / macOS / WSL2

​
Android / Termux

O Windows nativo não é suportado; instale o WSL2 e execute o Hermes Agent a partir do WSL2.

​
Step2: Escolher o provedor

Após a instalação bem-sucedida, selecione Quick setup -> More providers -> Custom endpoint.
Captura da etapa de escolha do provedor após instalar o Hermes
Captura da etapa de escolha do provedor no Hermes
Captura da escolha do Custom endpoint no Hermes

​
Step3: Configurar os parâmetros do AIHubMix

  1. Insira a API base URL: https://aihubmix.com/v1.
  2. Insira a AIHUBMIX_API_KEY: sk-***.
    Captura da etapa de preenchimento da API Key da AIHubMix no Hermes
  3. Insira o identificador do modelo e selecione o modelo que deseja usar.
Captura da etapa de preenchimento do identificador do modelo no Hermes

​
Step 4: Configurar a plataforma de mensagens

Configure a plataforma de mensagens conforme necessário (use Skip como referência) -> Se deseja executar (escolha Y)
Captura da configuração da plataforma de mensagens no Hermes
Captura da confirmação de execução no assistente de configuração do Hermes

​
Step 5: Executar o teste

  1. Digite hermes no terminal para acessar a página interativa do Hermes Agent.
    Captura da interface interativa do Hermes Agent
  2. Digite algo na caixa de diálogo; se o modelo responder normalmente, significa que a instalação foi bem-sucedida.
Captura da resposta do modelo no Hermes Agent

​
Conectar pelo plugin oficial

O método Custom endpoint descrito acima exige preencher a base URL e o identificador do modelo a cada vez. A AIHubMix oferece um plugin oficial de model provider (provedor de modelos): depois de instalado, a AIHubMix fica registrada no Hermes como o provedor aihubmix e pode ser chamada diretamente com --provider aihubmix. A lista de modelos é preenchida automaticamente pela interface de catálogo de modelos da AIHubMix. O plugin não altera nenhum arquivo do núcleo do Hermes. Código-fonte e documentação completa: AIhubmix/hermes-provider-aihubmix

​
Instalação

Copie o diretório do plugin para o diretório de model providers do Hermes:
O Hermes varre esse diretório na primeira consulta de provedores da próxima sessão. Não é preciso reiniciar nem alterar o arquivo de configuração. Também é possível instalar via pip:
Plugins instalados por entry point do pip não são carregados por padrão. É necessário executar hermes plugins enable aihubmix, que grava o plugin em plugins.enabled e o ativa.
hermes plugins install AIhubmix/hermes-provider-aihubmix não funciona com este plugin. O comando instala em ~/.hermes/plugins/<nome-do-repositório>/ e avisa que a raiz do repositório não tem plugin.yaml, enquanto model providers são descobertos apenas em ~/.hermes/plugins/model-providers/, de modo que o plugin nunca é registrado. O manifesto aihubmix/plugin.yaml declara kind: model-provider, mas o comando não lê esse campo ao escolher o diretório de instalação. Use um dos dois métodos acima. Esse comportamento foi verificado no Hermes 0.20.5.

​
Configurar a API Key

Obtenha a chave na página de API Keys. O hermes setup lê essa variável de ambiente e o hermes doctor a usa para testar a conectividade com a interface de catálogo de modelos.

​
Uso

Também é possível escolher o modelo de forma interativa com /model após selecionar a AIHubMix. A lista de modelos vem da interface de catálogo de modelos da AIHubMix e inclui apenas entradas marcadas com tools ou function_calling; basta uma das duas marcações. Se essa interface estiver indisponível, o plugin recorre à lista genérica /v1/models; se essa também estiver, usa uma pequena lista de reserva embutida. Defina AIHUBMIX_BASE_URL para apontar a um proxy ou a um relay próprio. Quando esse valor difere do endereço padrão, o plugin busca a lista de modelos pelo caminho genérico {base_url}/models.

​
Comandos comuns

Bloco de código

​
Perguntas frequentes

​
Por que o plugin não funciona depois de hermes plugins install?

Esse comando instala o plugin em ~/.hermes/plugins/<nome-do-repositório>/, enquanto o Hermes descobre model providers apenas em ~/.hermes/plugins/model-providers/, por isso o plugin não é registrado. O manifesto aihubmix/plugin.yaml declara kind: model-provider, mas o comando não lê esse campo ao escolher o diretório de instalação, então a instalação em si é reportada como bem-sucedida. Use a cópia de diretório mostrada acima ou instale via pip e execute hermes plugins enable aihubmix.

​
Qual a diferença entre o plugin e o método Custom endpoint?

O Custom endpoint exige preencher manualmente a base URL e o identificador do modelo. O plugin registra a AIHubMix como o provedor nomeado aihubmix, permitindo a chamada direta com --provider aihubmix; a lista de modelos é preenchida automaticamente pela interface de catálogo de modelos da AIHubMix e filtrada para modelos com suporte a chamadas de ferramentas.

​
O que fazer se a lista de modelos em /model estiver vazia ou muito curta?

Confirme primeiro com hermes doctor se AIHUBMIX_API_KEY está definida e válida. A lista inclui apenas modelos marcados com tools ou function_calling, portanto é menor que o catálogo completo. Se AIHUBMIX_BASE_URL estiver definida e diferente do endereço padrão, o plugin busca a lista em {base_url}/models.
Última atualização: 2026-08-25