O que é o LibreChat?
O LibreChat é uma plataforma de chat de código aberto e auto-hospedável projetada para unificar múltiplos provedores de IA por trás de uma única interface. Em vez de prender você a um único fornecedor, ele permite configurar vários provedores de IA e servidores de inferência locais lado a lado, e alternar entre eles no meio de uma conversa. O projeto é mantido por Danny Avila e pela comunidade LibreChat, hospedado em github.com/danny-avila/LibreChat, onde já ultrapassou 42.000 estrelas no GitHub.
- Chat multiprovedor: provedores de IA proprietários e modelos auto-hospedados/locais configurados como endpoints separados na mesma interface
- Endpoints personalizados: qualquer servidor compatível com a API da OpenAI — incluindo servidores de inferência locais — pode ser adicionado sem alterações de código, apenas com uma entrada de configuração
- Agentes: assistentes personalizados sem código com acesso a ferramentas, um marketplace de agentes e suporte a Model Context Protocol (MCP)
- Interpretador de código: execução isolada em várias linguagens, com manipulação de arquivos
- Artifacts: gera e renderiza componentes React, HTML e diagramas Mermaid diretamente no chat
- API de RAG: um serviço complementar (repositório separado) para enviar documentos e conversar com eles usando geração aumentada por recuperação
- Suporte multiusuário: login por e-mail/senha, OAuth2 (Google, GitHub, Discord e similares) e LDAP, permitindo implantação para uma equipe em vez de uma pessoa só
História e fundador: Danny Avila
O LibreChat foi criado por Danny Avila, um desenvolvedor autodidata que, segundo seu perfil público de autor no LibreChat, começou a programar em 2022 e antes trabalhava como contador, antes de migrar para a engenharia de software. O projeto começou sob o nome "ChatGPT Clone" como seu projeto final para o bootcamp de programação Hack Reactor, cuja tarefa era construir um projeto full-stack do zero em um prazo curto. Avila abriu o código do projeto no GitHub em 2023, e ele está em desenvolvimento contínuo desde então, crescendo de um clone de ChatGPT de provedor único para uma plataforma multiprovedor com agentes, MCP e uma API de RAG.
Avila continua sendo o fundador e mantenedor principal do projeto. O projeto também aceita contribuições da comunidade no GitHub e lista os autores do projeto no site de documentação oficial.
LibreChat e LLMs locais
O suporte a modelos locais no LibreChat funciona por meio do recurso de endpoints personalizados: qualquer servidor de inferência que exponha um endpoint de completions de chat compatível com a API da OpenAI pode ser registrado como provedor, ao lado de — ou no lugar de — serviços de IA proprietários.
- Ollama: o LibreChat lista explicitamente o Ollama entre seus "provedores de IA locais e remotos" documentados, tornando-o um alvo suportado nativamente
- LocalAI, text-generation-webui (oobabooga), LM Studio, vLLM: todos expõem APIs de completions de chat compatíveis com OpenAI, para as quais a configuração de endpoint personalizado do LibreChat pode apontar da mesma forma que para qualquer outro provedor
- Apple MLX e koboldcpp também são citados na lista documentada de provedores do projeto para inferência local/alternativa
- Uma configuração totalmente local — LibreChat mais um servidor de inferência local, sem chaves de API proprietárias configuradas — mantém os dados de conversa em infraestrutura que você controla e evita custos de API por token
- Vários endpoints, locais e remotos, podem ser configurados ao mesmo tempo — uma equipe pode oferecer tanto um modelo proprietário rápido quanto um modelo local privado na mesma instância do LibreChat, alternando por conversa
📌Nota: Uma configuração totalmente offline ainda exige que toda outra integração configurada (busca na web, ferramentas MCP que chamam APIs externas, geração de imagens via provedor remoto) seja desativada ou apontada para equivalentes locais — o endpoint personalizado torna as completions de chat locais, não todos os recursos por padrão.
Como o LibreChat funciona
O LibreChat é uma aplicação web auto-hospedada padrão: um backend em Node.js/Express, um frontend em React e o MongoDB como armazenamento de dados principal, distribuído como uma stack Docker Compose para que tudo suba com um único comando.
- Backend: Node.js com Express cuida das requisições de API, do roteamento de provedor/endpoint e da autenticação
- Frontend: uma aplicação React single-page serve a interface de chat no navegador
- Banco de dados: o MongoDB armazena conversas, usuários e configuração; um banco de dados vetorial dá suporte à API de RAG separada para os embeddings de documentos
- Implantação: o quick-start oficial usa Docker Compose para subir juntos o app, o banco de dados e os serviços de suporte
- Configuração: provedores e endpoints personalizados (incluindo servidores de inferência locais) são declarados em um arquivo de configuração YAML (librechat.yaml) mais variáveis de ambiente, não no código
Recursos: agentes, MCP, RAG, Artifacts
Além do chat básico, o conjunto de recursos do LibreChat se concentra em quatro áreas: agentes, acesso a ferramentas via MCP, recuperação sobre seus próprios arquivos e conteúdo interativo gerado.
- Agentes: assistentes personalizados sem código configuráveis por caso de uso, implantáveis individualmente e compartilháveis por meio de um marketplace de agentes dentro do app
- Model Context Protocol (MCP): os agentes podem chamar ferramentas e fontes de dados compatíveis com MCP, ampliando o que conseguem fazer além do próprio treinamento do modelo
- Interpretador de código: execução isolada com suporte a várias linguagens (incluindo Python, Node.js e outras, segundo a documentação do projeto), com suporte a upload/download de arquivos
- Artifacts: o modelo pode gerar, e a interface renderizar, componentes React, páginas HTML e diagramas Mermaid diretamente dentro da conversa
- API de RAG: um serviço complementar separado para upload de documentos e chat aumentado por recuperação sobre seus próprios arquivos
- Geração e edição de imagens: integrações com provedores como DALL-E, Stable Diffusion e Flux, além de ferramentas de imagem baseadas em MCP
- Autenticação multiusuário: e-mail/senha, OAuth2 (Google, GitHub, Discord e outros provedores) e LDAP para diretórios organizacionais
- Busca de conversas e interface multilíngue, adequadas para uso como implantação compartilhada voltada para equipes, em vez de ferramenta de usuário único
Testes e CI
O repositório do GitHub do LibreChat executa suas próprias verificações automatizadas via GitHub Actions, visíveis no diretório .github/workflows do repositório danny-avila/LibreChat. A PromptQuorum não executou a suíte de testes do LibreChat por conta própria; o que segue reflete o que os próprios arquivos de workflow do repositório indicam, conforme observado no GitHub.
- backend-review.yml e frontend-review.yml — workflows automatizados de revisão/verificação de código para as bases de código backend e frontend
- playwright-bombadil.yml e playwright-mock.yml — workflows de testes end-to-end usando Playwright, um deles rodando contra serviços simulados
- agents-integration-tests.yml e cache-integration-tests.yml — workflows de testes de integração voltados especificamente ao recurso de agentes e à camada de cache
- a11y.yml — um workflow de testes de acessibilidade
- static-checks.yml — análise estática de código
- docker-smoke.yml — um smoke test na imagem Docker construída antes da publicação
Como auto-hospedar o LibreChat?
O quick-start documentado implanta o LibreChat com Docker Compose, que sobe juntos o app, o MongoDB e os serviços de suporte.
- 1Instale o Docker e o Docker Compose se ainda não os tiver, no Linux, macOS ou Windows com WSL2.
- 2Clone o repositório: git clone https://github.com/danny-avila/LibreChat.git, depois cd LibreChat.
- 3Copie o arquivo de ambiente de exemplo: cp .env.example .env, e defina os valores para os provedores que pretende usar.
- 4Para adicionar um modelo local, crie ou edite o librechat.yaml e adicione um endpoint personalizado apontando para a URL compatível com OpenAI do seu servidor de inferência local (por exemplo, um servidor Ollama ou LM Studio rodando na mesma máquina ou na rede local).
- 5Suba a stack: docker compose up -d. Isso inicia backend, frontend e MongoDB juntos.
- 6Abra o app no navegador (padrão http://localhost:3080), registre a primeira conta e selecione seu endpoint configurado — proprietário ou local — para começar a conversar.
O LibreChat auto-hospedado precisa de GPU?
Não, não para o próprio LibreChat. O LibreChat é uma interface de chat e uma camada de orquestração — ele chama o endpoint que você configurar em vez de rodar a inferência do modelo internamente. A GPU só importa se você também estiver auto-hospedando o modelo local com o qual o LibreChat conversa, via um servidor de inferência separado como Ollama ou vLLM.
Posso rodar o LibreChat totalmente offline com modelos locais?
Sim, para o caminho de completions de chat: aponte o endpoint personalizado do LibreChat para um servidor local compatível com a API da OpenAI, como Ollama, LocalAI ou vLLM, e remova ou desative quaisquer chaves de provedores proprietários. Recursos que, por design, chamam serviços externos — busca na web, geração de imagens via provedor remoto, ou ferramentas MCP que acessam a internet — precisam ser desativados ou reconfigurados contra equivalentes locais para manter toda a implantação offline.
Para quem o LibreChat é indicado?
O LibreChat é indicado para equipes e indivíduos que querem uma única interface de chat abrangendo múltiplos provedores de IA, incluindo modelos locais, com espaço para crescer em direção a agentes, uso de ferramentas e implantação multiusuário.
Use o LibreChat se
- Você quer rodar provedores de IA proprietários e modelos locais/auto-hospedados lado a lado em uma única interface de chat, alternando por conversa
- Você precisa de acesso multiusuário com autenticação real (OAuth2, LDAP) em vez de um app de desktop de usuário único
- Você quer agentes com chamada de ferramentas MCP, um interpretador de código e RAG sobre arquivos sem montar ferramentas separadas para cada função
- Você está confortável auto-hospedando via Docker Compose e mantendo um serviço apoiado em MongoDB
- A licença MIT importa para você — sem restrição SaaS multi-tenant a verificar antes de implantar comercialmente
Evite o LibreChat se
- Você quer um app de desktop de usuário único sem nenhuma configuração de servidor — uma ferramenta como LM Studio ou Jan tem um caminho muito mais curto até o primeiro chat
- Seu caso de uso principal é roleplay centrado em personagens com lorebooks e fichas de persona — o SillyTavern foi feito exatamente para isso, o LibreChat não
- Você precisa de um fluxo de RAG de documentos com configuração mínima — um app de RAG dedicado pode chegar lá com menos peças móveis do que conectar a API de RAG separada do LibreChat
- Você não quer operar MongoDB e uma stack Docker Compose por conta própria, e não tem interesse em nenhuma alternativa gerenciada
LibreChat vs. Open WebUI, SillyTavern, AnythingLLM
O LibreChat se sobrepõe mais ao Open WebUI como frontend de chat auto-hospedado e multimodelo para LLMs locais e remotos — a diferença está na ênfase: o LibreChat pende para chat multiprovedor, agentes e uso de ferramentas MCP; o Open WebUI pende para ser a alternativa padrão auto-hospedada ao ChatGPT com RAG embutido; SillyTavern e AnythingLLM têm especializações mais estreitas.
Ferramenta | Foco | Licença | Suporte a LLM local |
|---|---|---|---|
| LibreChat | Chat multiprovedor / agentes / MCP | MIT | Endpoints personalizados compatíveis com OpenAI |
| Open WebUI | Alternativa auto-hospedada ao ChatGPT, RAG embutido | BSD 3-Clause | Ollama nativo + compatível com OpenAI |
| SillyTavern | Roleplay de personagens, lorebooks | AGPL 3.0 | KoboldCpp, text-gen-webui e mais |
| AnythingLLM | RAG de documentos, workspaces | MIT | Ollama, LM Studio, LocalAI |
O número de estrelas e os conjuntos de recursos mudam; verifique os números atuais na página do GitHub de cada projeto antes de citá-los. No momento desta análise, o Open WebUI tem a maior comunidade no GitHub deste grupo, AnythingLLM e LibreChat são amplamente comparáveis em escopo para chat com LLM local mais extras, e o SillyTavern é o menor, mas o mais especializado em roleplay.
Erros comuns ao avaliar o LibreChat
Esses erros vêm de tratar o LibreChat como um app de desktop de usuário único, ou de assumir que todo recurso funciona offline por padrão assim que um endpoint local é adicionado.
Erro 1: assumir que um endpoint personalizado local deixa toda a implantação offline
Adicionar um servidor de inferência local como endpoint personalizado torna as completions de chat locais. Busca na web, ferramentas MCP que chamam APIs externas e geração de imagens via provedor remoto são integrações separadas que continuam acessando a internet, a menos que você as desative ou as aponte para equivalentes locais.
Erro 2: pular o planejamento do MongoDB
O LibreChat depende do MongoDB como seu armazenamento de dados principal. Tratar o auto-hospedagem como "simplesmente rodar um container", sem um plano de backup para o banco de dados, ou rodá-lo em armazenamento efêmero, arrisca perder o histórico de conversas e a configuração.
Erro 3: comparar o LibreChat com o SillyTavern em recursos de roleplay
O LibreChat não é construído em torno de lorebooks, fichas de personagem ou roleplay guiado por persona da forma como o SillyTavern é. Avaliá-lo contra o SillyTavern nesse caso de uso específico o prepara para perder uma comparação que ele nunca foi projetado para vencer — a comparação mais relevante para o LibreChat é o Open WebUI ou o AnythingLLM.
Perguntas frequentes
O LibreChat é gratuito?
Sim. O LibreChat é totalmente de código aberto sob a licença MIT, gratuito para uso pessoal e comercial em auto-hospedagem, sem restrição SaaS multi-tenant a verificar antes de implantá-lo comercialmente.
Quem criou o LibreChat?
Danny Avila criou o LibreChat, originalmente como projeto final (então chamado "ChatGPT Clone") para o bootcamp de programação Hack Reactor em 2023. Ele continua sendo o fundador e mantenedor principal do projeto, com colaboradores da comunidade no GitHub.
O LibreChat suporta LLMs locais como o Ollama?
Sim. O LibreChat lista o Ollama entre seus provedores de IA locais e remotos documentados, e seu recurso de endpoints personalizados pode se conectar a qualquer servidor local compatível com a API da OpenAI, incluindo LocalAI, text-generation-webui, LM Studio e vLLM.
O LibreChat pode rodar totalmente offline?
O caminho de completions de chat pode rodar totalmente offline uma vez apontado para um endpoint local compatível com OpenAI, com chaves de provedores proprietários removidas. Outras integrações — busca na web, geração de imagens remota, ferramentas MCP que acessam a internet — precisam ser desativadas ou reconfiguradas localmente para que toda a implantação fique offline.
O que o LibreChat usa como banco de dados?
O MongoDB é o armazenamento de dados principal para conversas, usuários e configuração. Um banco de dados vetorial separado dá suporte à API de RAG complementar para os embeddings de documentos.
O LibreChat suporta agentes e uso de ferramentas?
Sim. Os Agentes do LibreChat são assistentes personalizados sem código que podem chamar ferramentas via Model Context Protocol (MCP), executar um interpretador de código isolado e ser publicados em um marketplace de agentes dentro do app.
Como o LibreChat se diferencia do Open WebUI?
Ambos são frontends de chat auto-hospedados, com licença MIT/BSD, que suportam LLMs locais e remotos. O LibreChat pende mais para alternância multiprovedor, agentes e uso de ferramentas MCP; o Open WebUI vem com RAG embutido e é, de forma geral, a alternativa padrão auto-hospedada ao ChatGPT mais amplamente adotada no momento desta análise — verifique os números de adoção atuais antes de citá-los, já que ambos os projetos evoluem rapidamente.
Como o LibreChat se diferencia do SillyTavern?
O SillyTavern é construído especificamente para roleplay centrado em personagens com lorebooks e fichas de persona. O LibreChat é uma plataforma de chat multiprovedor geral com agentes e RAG; não é projetado para substituir o SillyTavern em fluxos específicos de roleplay.
O LibreChat precisa de GPU para auto-hospedagem?
Não, não para o próprio LibreChat — ele é uma camada de orquestração e interface de chat. A GPU só importa se você estiver auto-hospedando separadamente o modelo local ao qual o LibreChat se conecta, via algo como Ollama ou vLLM.
A PromptQuorum testou o desempenho do LibreChat ou executou sua suíte de testes?
Não. Esta análise reporta o que o próprio repositório do GitHub do LibreChat, sua documentação e os perfis públicos de autores afirmam — incluindo os arquivos de workflow de CI visíveis em seu diretório .github/workflows — em vez de benchmarks ou testes independentes realizados pela PromptQuorum.