Guia de integração de agente
Use Hermes com a API LLM da WaveSpeed
Este guia mostra como conectar Hermes à WaveSpeed AI com ~/.hermes/config.yaml, Chat completions compatíveis com OpenAI, /v1/chat/completions, base URL https://llm.wavespeed.ai/v1 e modelo padrão anthropic/claude-opus-4.8. Copie a configuração acima, exporte sua API key, execute o agente e verifique os requests em Logs.
Crie uma chave de acesso WaveSpeed
Exporte localmente a chave necessária
Cole a configuração em
~/.hermes/config.yamlExecute hermes chat e confira Logs
O que este setup de Hermes configura
Protocolo
Chat completions compatíveis com OpenAI
Endpoint
/v1/chat/completions
Modelo
anthropic/claude-opus-4.8
A configuração pronta para copiar acima é o único arquivo Hermes que você precisa editar no setup recomendado: ~/.hermes/config.yaml. Mantenha a API key no ambiente shell para não enviá-la a um repositório.
Solução de problemas
A API key não está sendo lida
Exporte WAVESPEED_API_KEY na mesma shell em que você executa Hermes. Se usar um perfil de shell, recarregue o terminal antes de iniciar o agente.
Requests falham com erro de protocolo ou endpoint
Confira se Hermes está usando Chat completions compatíveis com OpenAI e endpoint /v1/chat/completions. Incompatibilidades de protocolo são a causa mais comum de erros 404 ou payload.
O modelo selecionado não funciona
Confirme que o ID do modelo existe em WaveSpeed Models e cole o ID exato em ~/.hermes/config.yaml. Você pode começar com o modelo padrão mostrado nesta página.
Nenhum request aparece em Logs
Garanta que Hermes use a base URL da WaveSpeed e sua API key atual. Depois envie um novo prompt pelo agente local e atualize Logs.
Este guia de Hermes pode aparecer em buscas?
Sim. Esta página foi criada como um guia de setup indexável para usuários que pesquisam Hermes custom provider, endpoint compatível com OpenAI, base URL e fluxos de configuração local de agentes.