> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LibreChat

> Conecte o LibreChat ao AIHubMix pelo endpoint compatível com OpenAI.

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](https://aihubmix.com/token), 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:

```env theme={null}
OPENAI_API_KEY=sua_chave_AIHubMix
OPENAI_REVERSE_PROXY=https://aihubmix.com/v1
```

Se você não quiser salvar a key em `.env`, use o modo fornecido pelo usuário do LibreChat:

```env theme={null}
OPENAI_API_KEY=user_provided
OPENAI_REVERSE_PROXY=https://aihubmix.com/v1
```

`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:

```env theme={null}
OPENAI_REVERSE_PROXY=https://api.inferera.com/v1
```

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:

```env theme={null}
OPENAI_MODELS=gpt-4o-mini,gpt-5.5,claude-haiku-4-5,deepseek-chat,gemini-3.5-flash,glm-5.2
```

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.

<img src="https://mintcdn.com/aihubmix/j4q_-ouc8NkeJVBQ/public/cn/LibreChat-new-01.png?fit=max&auto=format&n=j4q_-ouc8NkeJVBQ&q=85&s=c0d1e2c385d904659570e6ab9f8a8fbf" alt="Seletor de modelos AIHubMix no LibreChat" width="1910" height="925" data-path="public/cn/LibreChat-new-01.png" />

## Referências

* AIHubMix: [aihubmix.com](https://aihubmix.com)
* LibreChat: [librechat.ai](https://www.librechat.ai/)
* Instalação local do LibreChat: [librechat.ai/docs/local/npm](https://www.librechat.ai/docs/local/npm)
* LibreChat `.env.example`: [github.com/danny-avila/LibreChat/blob/main/.env.example](https://github.com/danny-avila/LibreChat/blob/main/.env.example)

***

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