Saltar para o conteúdo principal
LibreChat é um cliente de chat multimodelo open source. Depois de conectar o AIHubMix, modelos OpenAI, Claude, Gemini, DeepSeek, GLM e outros modelos suportados pelo AIHubMix podem ser usados no endpoint OpenAI do LibreChat.

Pré-requisitos

Antes de configurar, confirme que:
  • O LibreChat está instalado e em execução. A versão v0.7.5 ou superior é recomendada.
  • Você criou uma API key no console do AIHubMix, geralmente no formato sk-***.
  • Você pode editar o arquivo .env no diretório de instalação do LibreChat. Normalmente ele fica na raiz do projeto, ao lado de package.json e docker-compose.yml.
  • O caminho costuma ser seu-caminho-de-instalacao/LibreChat/.env. Se o arquivo não existir, copie .env.example no mesmo diretório e renomeie para .env.

Configurar .env

Abra o .env na raiz do projeto LibreChat e adicione ou atualize estas linhas:
Se você não quiser salvar a key em .env, use o modo fornecido pelo usuário do LibreChat:
user_provided faz o LibreChat pedir a API key ao usuário atual pela interface. Nos dois modos, os modelos do AIHubMix aparecem no endpoint OpenAI. Se o domínio principal da API estiver indisponível, use o domínio de backup:
Por padrão, a lista de modelos é retornada pelo AIHubMix. Normalmente não é necessário configurar OPENAI_MODELS. Para mostrar apenas alguns modelos, adicione uma lista separada por vírgulas:
Para mostrar a lista completa de modelos suportados pelo AIHubMix, não configure OPENAI_MODELS ou mantenha a linha # OPENAI_MODELS=... comentada.

Reiniciar o LibreChat

Depois de modificar .env, reinicie o LibreChat:
  • Script local: execute novamente seu script de inicialização do LibreChat.
  • Código-fonte ou npm: entre na raiz do projeto LibreChat, onde está .env, e rode o comando normal de inicialização.
  • Docker: execute docker compose restart no diretório que contém docker-compose.yml ou reinicie o contêiner.

Resultado

Depois de reiniciar, escolha OpenAI no seletor de endpoint/modelo do LibreChat e selecione o modelo do AIHubMix desejado. Se OPENAI_MODELS não estiver definido, a lista vem do AIHubMix. Seletor de modelos AIHubMix no LibreChat

Referências


Última atualização: 2026-07-03