Hermes Agent com Muapi

Configure a Muapi como endpoint personalizado compatível com OpenAI para usar seus modelos de texto no Hermes Agent.

1. Crie uma chave e escolha um modelo

Crie uma chave de API no painel da Muapi e liste os modelos:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Escolha um modelo com capabilities.tools: true. Os fluxos de agente do Hermes exigem janela de contexto de pelo menos 64.000 tokens; confira o limite antes de selecionar.

2. Configure o Hermes Agent

Execute o assistente de configuração:

hermes model

Escolha Custom endpoint e informe a URL base https://api.muapi.ai/v1, sua chave Muapi e o ID exato do modelo.

Como alternativa, configure ~/.hermes/config.yaml:

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

Guarde a chave em ~/.hermes/.env:

MUAPI_API_KEY=your-muapi-api-key

Substitua YOUR_MODEL_ID pelo ID exato retornado pela Muapi.

3. Inicie o Hermes Agent

hermes
# Ou:
hermes --tui

Teste uma tarefa pequena com ferramenta. Depois que o modelo funcionar, conecte plataformas de mensagens com hermes gateway setup.

Solução de problemas

• Confira se a URL termina em /v1, se a chave está disponível e se o ID está correto.
• Para ferramentas, escolha um modelo com capabilities.tools: true.
• O Hermes exige contexto de pelo menos 64K tokens.
• Comece com uma tarefa curta e confira o uso no painel Muapi.

Consulte a documentação de provedores do Hermes Agent e o guia de configuração.