Guia de agentes da Flaq AI

Guia prático para usar o Hermes Agent com os serviços de API da Flaq AI

Use o endpoint compatível com Hermes Agent da Flaq AI para configurar rapidamente o Hermes Agent com a Flaq e acessar nossos serviços de modelos pelo terminal. Depois de configurar sua chave de API, siga os exemplos deste guia para escolher um modelo atualmente compatível e verificar a configuração.

Guias de agentes

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

Instalar

Instalar o Hermes Agent

Instale o Hermes Agent para o seu sistema, recarregue seu shell se necessário e verifique o comando hermes antes de adicionar as configurações da Flaq AI. Se o instalador abrir o assistente de configuração, você pode pular o login no Nous Portal e configurar a Flaq manualmente depois.

1

Instalar o Hermes Agent

Escolha o instalador correspondente ao seu sistema e execute o comando de instalação abaixo.

  • O instalador pode abrir o assistente de configuração do Hermes.
  • Para a configuração da Flaq, você pode pular o login no Nous Portal e continuar com a configuração manual abaixo.

Script oficial de instalação

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
2

Recarregar perfil do shell

Execute isto após a instalação se o comando hermes ainda não estiver disponível. Use source ~/.bashrc se seu shell usa bash.

Recarregar perfil do shell

source ~/.zshrc
3

Verificar o Hermes Agent

Confirme que o comando hermes está disponível antes de adicionar as credenciais da Flaq AI.

Verificar instalação

hermes --version

Configurar

Conectar o Hermes Agent à Flaq AI

Escolha um modelo atualmente compatível com o endpoint compatível com OpenAI da Flaq, armazene sua chave de API da Flaq em ~/.hermes/.env e aponte config.yaml para a URL base da API da Flaq.

Modelo de texto recomendado como padrão confiável para um fluxo de codificação com Hermes Agent.

Use comandos da Hermes CLI para gravar a chave de API da Flaq e as configurações do modelo com menos edições manuais de arquivos. Isso atualiza suas configurações locais do Hermes, então faça backup da configuração existente primeiro se você já usa Hermes.

Grava a chave da Flaq, o modelo selecionado, o provedor personalizado, a URL base e o tamanho de contexto por meio de comandos de configuração do Hermes.

Configuração rápida com Hermes CLI

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

Verificar

Verificar a Flaq no Hermes Agent

Execute um comando rápido único do Hermes. Uma resposta normal significa que o Hermes consegue chamar modelos pelo endpoint LLM da Flaq.

Iniciar modo interativo

hermes

Comando de teste rápido

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

Diagnóstico de configuração

hermes config check

Definir o modelo selecionado como padrão

hermes config set model.default gpt-5.4-text-to-text

Solução de problemas

FAQ do Hermes Agent

Usar esta configuração do guia pode aumentar significativamente o uso de tokens.