LibreChat: A self-hosted platform unifying multi-model chat, Agents, and code execution
A self-hosted multi-model AI chat platform for teams, combining Agents, MCP, and code execution in one interface.
GitHub danny-avila/LibreChat Updated 2026-09-16 Branch main Stars 43.8K Forks 9.0K
TypeScript Multi-model chat MCP Code Interpreter Self-hosting

🧭 Decision Guide

Try it if you

  • You need one interface to switch between OpenAI, Anthropic, Vertex AI, and Ollama.
    The README section “AI Model Selection” lists these providers and supports Local & Remote AI Providers.
  • Your Agent needs MCP Servers, Skills, Subagents, or Code Interpreter.
    The README section “Agents & Tools Integration” explicitly lists MCP, Skills, Subagents, and code execution.
  • You need a self-hosted multi-user service with OAuth2, LDAP, Email Login, and an Admin Panel.
    The README sections “Multi-User & Secure Access” and “Admin Panel” list authentication and user/role management.

Skip it if you

  • You require Attached Code Workspaces to have stable production guarantees.
    The README labels Attached Code Workspaces as highly experimental.
  • You only need a single-model client and do not need MCP, Agents, or multi-provider switching.
    The README’s core features cover multiple providers, Agents, MCP, Code Interpreter, and model switching.
  • You cannot accept a release candidate as the current latest version.
    Project metadata identifies v0.8.8-rc3 as the latest version.

Requirements

  • You need to deploy a self-hosted AI chat platform.
  • You need to configure at least one AI provider, such as OpenAI, Anthropic, Google, or Ollama.
  • For Custom Endpoints, you need an OpenAI-compatible API; the README states no proxy required.
  • For multi-server Resumable Streams, you need Redis.
  • For administration, you need to use the Admin Panel deployment provided by the Docker Compose stacks.

Watch out

  • Enabling Attached Code Workspaces puts you in a highly experimental feature area.
    The README section “Agents & Tools Integration” explicitly labels Attached Code Workspaces as highly experimental.
  • Agent Plugins are not presented as stable; the README describes them as experimentally bundle.
    The README’s “Agent Plugins” item describes experimentally bundling deployment Skills and MCP servers.
  • Cross-server response recovery depends on Redis rather than being a default single-server capability.
    The README section “Resumable Streams” states that horizontally scaled deployments use Redis.

Alternatives

  • Official client from a single vendor:Better when you use only one provider such as OpenAI or Anthropic and do not need self-hosting, MCP, or multi-user administration.
    General domain knowledge
  • Lightweight OpenAI-compatible web UI:Better when you only need basic chat through one OpenAI-compatible API and do not need Agents, Code Interpreter, or OAuth2/LDAP.
    README sections “AI Model Selection” and “Multi-User & Secure Access”

Not stated in the README

  • The provided README material does not include the actual Docker Compose startup command.
  • It does not specify required Node.js, Go, database, or Redis versions.
  • It does not specify the credential configuration format for OpenAI, Anthropic, Ollama, or other providers.
  • It does not provide CPU, memory, or concurrency limits for the Code Interpreter sandbox.
  • It does not provide concrete configuration examples for OAuth2, LDAP, or Email Login.
  • It does not explain the changes or compatibility of v0.8.8-rc3 versus a stable release.
  • It does not provide end-to-end deployment steps for Agents, MCP Servers, and Subagents.

💡 Deep Analysis

6
Yes We maintain integrations for OpenAI, Anthropic, Azure, AWS Bedrock, and DeepSeek, while also needing a custom OpenAI-compatible Endpoint. Can we use LibreChat to unify model and Preset management instead of building a separate chat frontend for each provider?
For: An integration team that must switch among OpenAI, Anthropic, Azure, AWS Bedrock, and DeepSeek while already operating an OpenAI-compatible API

Yes, because LibreChat is specifically designed to place multiple providers and custom Endpoints behind one ChatGPT-style interface, although it cannot erase model capability differences.

  • The README lists Anthropic, AWS Bedrock, OpenAI, Azure OpenAI, Google, Vertex AI, and the Responses API.
  • It supports any OpenAI-compatible API without requiring a proxy.
  • Presets can be created, saved, shared, and switched together with AI Endpoints during a conversation.
  • Project data lists DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, Mistral, and OpenRouter among supported integrations.

This can remove repeated work on chat UI, conversations, and model switching. Tool calling, vision, files, context length, streaming behavior, and prompt compatibility still need provider-specific validation. The README does not describe cross-provider configuration migration, unified billing analytics, or automatic capability fallback.

  • README “AI Model Selection”: Anthropic, AWS Bedrock, OpenAI, Azure OpenAI, Google, Vertex AI, and OpenAI Responses API
  • README “AI Model Selection”: “Use any OpenAI-compatible API with LibreChat, no proxy required”
  • README “Presets & Context Management”: “Switch between AI Endpoints and Presets mid-chat”
  • Project data description: DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, Mistral, and OpenRouter
Not stated in the README:The README does not specify a common error, billing, or capability-discovery interface across providers;The README does not provide the complete migration format for all Endpoint configurations
Yes I want to create reusable SKILL.md bundles, connect MCP tools, delegate work to Subagents, and execute Python, Node.js, and Go. Is LibreChat suitable as this Agent workbench?
For: An Agent developer building internal automation assistants with MCP, Skills, Subagents, and Code Interpreter

Yes, because the README combines reusable instructions, MCP tools, Subagents, file search, and isolated code execution in a way that directly matches this workbench requirement.

  • Skills use reusable SKILL.md instruction bundles for manual, automatic, or always-on Agent workflows.
  • Agents can use MCP Servers, tools, file search, and code execution; Subagents delegate focused work with separate context windows.
  • The Agent Management API can automate Agent, file, and Skill management with deployment-bound OIDC clients.
  • The Code Interpreter sandbox supports Python, Node.js (JS/TS), Go, C/C++, Java, PHP, Rust, and Fortran.

However, Attached Code Workspaces are marked “highly experimental” in the README. MCP, Actions, and code execution also expand the attack surface and can increase token usage, latency, and failure propagation. The README does not specify approval workflows, resource limits, or per-tool invocation limits for MCP and Agent calls.

  • README “Agents & Tools Integration”: reusable `SKILL.md` instruction bundles
  • README “Agents & Tools Integration”: MCP Servers, tools, file search, code execution, and Subagents
  • README “Agents & Tools Integration”: Agent Management API with deployment-bound OIDC clients
  • README “Code Interpreter API”: supports Python, Node.js, Go, C/C++, Java, PHP, Rust, and Fortran
  • README “Agents & Tools Integration”: Attached Code Workspaces are marked highly experimental
Not stated in the README:The README does not specify per-tool MCP authorization, sandbox network policy, or resource quota configuration;The README does not specify maximum Subagent nesting depth, concurrency limits, or retry behavior
Yes I need users to upload images and files in the same conversation, analyze them with GPT-4o, Claude 3, or Gemini, and then generate React, HTML, Mermaid, and images. Can LibreChat cover this workflow?
For: A multimodal application developer working with images, documents, GPT-4o, Claude 3, Gemini, DALL-E 3, and Stable Diffusion

Yes. The README directly supports multimodal input, file conversations, code artifacts, and image generation, although the final behavior still depends on the selected model and external service.

  • Multimodal & File Interactions lists image upload and analysis with Claude 3, GPT-4.5, GPT-4o, o1, Llama-Vision, and Gemini.
  • The same section supports file conversations through Custom Endpoints, OpenAI, Azure, Anthropic, AWS Bedrock, and Google.
  • Code Artifacts can generate React, HTML, and Mermaid in chat, with preview and Mermaid export to SVG or PNG.
  • Image Generation & Editing supports GPT-Image-1, DALL-E 3/2, Stable Diffusion, Flux, and MCP image services.

It is therefore suitable as a unified multimodal workbench, not a guarantee that every model offers identical vision, file, code, and image capabilities. The README does not specify per-model file-type limits, maximum upload sizes, execution isolation for generated UI, or image-service cost and retention rules.

  • README “Multimodal & File Interactions”: Claude 3, GPT-4.5, GPT-4o, o1, Llama-Vision, and Gemini
  • README “Multimodal & File Interactions”: chat with files using Custom Endpoints, OpenAI, Azure, Anthropic, AWS Bedrock, and Google
  • README “Generative UI with Code Artifacts”: create React, HTML, and Mermaid content
  • README “Image Generation & Editing”: GPT-Image-1, DALL-E, Stable Diffusion, Flux, and MCP
Not stated in the README:The README does not specify supported file types, upload sizes, or context limits for each model;The README does not state whether the generative UI preview or export process executes user-generated code;The README does not specify actual image-service costs, retention, or regional restrictions
Yes I need multi-tab and multi-device synchronization, horizontal deployment with Redis, and continued AI streaming after a user disconnects. Does LibreChat satisfy this deployment constraint?
For: A web operations engineer scaling a chat application from one server to Redis-backed horizontal deployment with resumable streaming

Yes. The README explicitly groups resumable streaming, multi-tab use, multi-device synchronization, and Redis-backed horizontal scaling as supported capabilities.

  • The Resumable Streams section says AI responses automatically reconnect and resume after a dropped connection, so responses are not lost.
  • The same section supports opening the same chat in multiple tabs or continuing it on another device.
  • It explicitly states that the feature works from single-server setups to horizontally scaled deployments with Redis.
  • Project insights also identify optional Redis support for resumable streams and horizontal scaling.

It is therefore a closer match than a chat frontend that only provides ordinary WebSocket or one-shot HTTP streaming. However, the README does not specify Redis versions, persistence requirements, failover semantics, load-balancer stickiness, or the recovery window; these details remain important for production deployment.

  • README “Resumable Streams”: AI responses automatically reconnect and resume if the connection drops
  • README “Resumable Streams”: Multi-Tab & Multi-Device Sync
  • README “Resumable Streams”: works from single-server setups to horizontally scaled deployments with Redis
  • Project insights “architectural_strengths”: resumable streaming, cross-device synchronization, and optional Redis support
Not stated in the README:The README does not specify supported Redis versions, persistence settings, or failover semantics;The README does not state whether the load balancer requires sticky sessions or how long resumable streams are retained
It depends I mainly use Ollama or another OpenAI-compatible local service, want a ChatGPT-style interface for file analysis, and prefer not to depend on cloud models by default. Is LibreChat suitable for me?
For: An individual developer who needs local or private-infrastructure model access and strict control over data flows

It depends: LibreChat fits as a self-hosted interface for local models, but whether file workflows remain fully local depends on your Endpoint configuration.

  • The README explicitly supports local or remote providers such as Ollama, Apple MLX, and koboldcpp, plus “any OpenAI-compatible API.”
  • File interactions support Custom Endpoints, but file analysis, vision, and context capabilities differ between models.
  • The Code Interpreter is a separate sandbox service for uploading, processing, and downloading files; that does not mean model inference is local.
  • Web Search, Jina reranking, cloud speech, or image services may send data outside the private environment.

It is therefore suitable for a local-model portal, not an automatic guarantee of end-to-end offline operation. The README does not specify Ollama’s exact file-analysis compatibility, default retention policy, or data flows for every auxiliary service.

  • README “AI Model Selection”: supports Ollama, Apple MLX, koboldcpp, and any OpenAI-compatible API
  • README “Multimodal & File Interactions”: supports Custom Endpoints, OpenAI, Azure, Anthropic, AWS Bedrock, and Google
  • README “Code Interpreter API”: “Secure, Sandboxed Execution” and file upload, processing, and download
  • Project insights “usage_limitations”: cloud models, search, reranking, or speech may move data outside the local environment
Not stated in the README:The README does not provide a detailed compatibility matrix between Ollama and file or vision workflows;The README does not specify default retention and transfer policies for every external service
It depends I need to provide employees with a unified chat entry point using OAuth2 or LDAP, role and group permissions, and token-usage visibility. Can LibreChat serve as an organizational AI portal?
For: An organization administrator building an internal AI portal that needs OAuth2, LDAP, roles, groups, and token-usage controls

It depends: LibreChat exposes the authentication and governance capabilities expected of an organizational portal, but its built-in features should not be treated as a complete enterprise security or compliance program.

  • Project insights list OAuth2, LDAP, email login, roles, groups, an admin panel, auditing, and token-consumption management.
  • The README’s Agents section supports sharing Agents with specific users and groups, showing that the permission model is not limited to single-user use.
  • The README’s Observability section supports OpenTelemetry and Langfuse for Agent and model insights.
  • With self-hosting, the operator remains responsible for upgrades, backups, logs, key rotation, storage, and recovery.

It is therefore viable as an internal AI workspace, especially when the organization needs a unified model and Agent entry point. High-compliance deployments still need to verify retention, audit depth, tenant isolation, administrator controls, and identity integration. The README does not provide a complete compliance checklist or deployment procedure for each identity source.

  • Project insights “core_problems”: OAuth2, LDAP, email login, roles and groups, and token-consumption control
  • README “Agents & Tools Integration”: “Share agents with specific users and groups”
  • README “Observability”: export traces and logs with OpenTelemetry and connect Langfuse
  • Project insights “common_pitfalls”: operators own upgrades, backups, logs, key rotation, storage, monitoring, and recovery
Not stated in the README:The README does not describe the exact configuration process for OAuth2 or LDAP with an existing enterprise identity platform;The README does not define the boundaries of tenant isolation, retention, administrator auditing, or compliance certification

✨ Highlights

  • Supports OpenAI, Claude, Gemini, and Ollama
  • Code Interpreter sandbox covers Python, Go, and Rust
  • Agents integrate MCP, Skills, and Subagents
  • 43,838 stars with 254 added today

🔧 Engineering

  • Connect any OpenAI-compatible API with Custom Endpoints
  • Code Interpreter supports Python, Node.js, Go, and more
  • Agents can combine MCP Servers, Skills, and file search
  • OpenTelemetry and Langfuse provide model and Agent observability
  • Redis supports multi-server Resumable Streams and device sync

⚠️ Risks

  • README marks Attached Code Workspaces as highly experimental
  • Agent Plugins are still in the experimentally bundle stage
  • The latest version v0.8.8-rc3 is a release candidate
  • Multi-model capabilities depend on external OpenAI, Anthropic, and other services

👥 For who?

  • Teams needing a self-hosted entry point for OpenAI, Claude, and Gemini
  • Developers wanting Agents to use MCP, Skills, and Code Interpreter
  • Operators needing multi-user deployment with OAuth2, LDAP, and Email Login