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
.envno diretório de instalação do LibreChat. Normalmente ele fica na raiz do projeto, ao lado depackage.jsonedocker-compose.yml. - O caminho costuma ser
seu-caminho-de-instalacao/LibreChat/.env. Se o arquivo não existir, copie.env.exampleno mesmo diretório e renomeie para.env.
Configurar .env
Abra o .env na raiz do projeto LibreChat e adicione ou atualize estas linhas:
.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:
OPENAI_MODELS. Para mostrar apenas alguns modelos, adicione uma lista separada por vírgulas:
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 restartno diretório que contémdocker-compose.ymlou reinicie o contêiner.
Resultado
Depois de reiniciar, escolha OpenAI no seletor de endpoint/modelo do LibreChat e selecione o modelo do AIHubMix desejado. SeOPENAI_MODELS não estiver definido, a lista vem do AIHubMix.

Referências
- AIHubMix: aihubmix.com
- LibreChat: librechat.ai
- Instalação local do LibreChat: librechat.ai/docs/local/npm
- LibreChat
.env.example: github.com/danny-avila/LibreChat/blob/main/.env.example
Última atualização: 2026-07-03