Agent之ChatUI:LibreChat的简介、安装和使用方法、案例应用之详细攻略

Agent之ChatUI:LibreChat的简介、安装和使用方法、案例应用之详细攻略

目录

LibreChat的简介

1、特点

LibreChat的安装和使用方法

1、安装

1)从仓库结构看,项目提供了完整的部署与配置入口

2)官方支持的部署方式

3)配置方式

2、使用方法

1)多种后端与接口接入

2)使用方式的核心思路

3)面向团队的使用路径

LibreChat的案例应用

1)把多个模型放在一个统一界面里用

2)面向开发者的代码与原型工作流

3)企业知识与多用户协作

4)文档、文件和多模态分析

5)联网检索增强问答

6)长对话与多端续接

7)图像生成与编辑场景


LibreChat 简介

LibreChat 可以理解为一个开源、自托管的"增强版 ChatGPT 克隆"。仓库标题和简介明确写到,它支持 Features, Agents, MCP, Skills, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, GPT-5, Gemini, Artifacts, Code Interpreter, message search, open-source for self-hosting 等能力,目标是让用户在一个界面里统一管理和使用多个 AI 生态。

README 进一步说明,LibreChat 不只是聊天界面,它还提供 AI Agents、Model Context Protocol (MCP) 支持、Artifacts、Code Interpreter、custom actions、conversation search、enterprise-ready multi-user authentication,强调的是"把聊天、工具、工作流和企业级访问控制合并在一起"。

Github地址https://github.com/danny-avila/LibreChat

1、 特点

|--------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| 统一多家主流模型与推理接口 | LibreChat 支持 Anthropic(Claude)、AWS Bedrock、OpenAI、Azure OpenAI、Google、Vertex AI、OpenAI Responses API(含 Azure)等主流模型供应方;同时还支持任意 OpenAI-compatible 的自定义端点,不需要 proxy。它也兼容多种本地与远程提供方,如 Ollama、groq、Cohere、Mistral AI、Apple MLX、koboldcpp、together.ai、OpenRouter、Helicone、Perplexity、ShuttleAI、Deepseek、Qwen 等。 |
| Code Interpreter 与安全沙箱 | 仓库把 Code Interpreter API 作为核心特性之一,支持在 Python、Node.js(JS/TS)、Go、C/C++、Java、PHP、Rust、Fortran 中进行安全、沙箱化执行,并且支持文件上传、处理、下载,强调执行环境是完全隔离的。 |
| Agents、Skills、Subagents、MCP 的组合式能力 | LibreChat 的 Agents & Tools Integration 很完整:它支持 No-Code Custom Assistants、Agent Marketplace、共享给特定用户或群组、MCP Servers、tools、file search、code execution 等。仓库还明确列出 Skills:可创建可复用的 SKILL.md 指令包,用于手动、自动或 always-on 的 agent 工作流;以及 Subagents:把专门任务委派给隔离的子代理运行。 |
| Web Search 与结果重排 | README 写明它支持联网搜索,能够结合搜索提供方、内容抓取器和结果重排器提升上下文质量,还支持自定义 Jina reranking API URL。 |
| Generative UI 与代码工件 | LibreChat 提供 Code Artifacts,可在聊天中直接创建 React、HTML 和 Mermaid 图表,这意味着它不仅能"回答问题",还能把结果做成可视化或可运行的产物。 |
| 图像生成、编辑与多模态文件交互 | 仓库列出图像生成与编辑能力,支持 GPT-Image-1 的 text-to-image / image-to-image,也支持 DALL-E(3/2)、Stable Diffusion、Flux,甚至可通过任意 MCP server 做图像生成。多模态方面,它支持用 Claude 3、GPT-4.5、GPT-4o、o1、Llama-Vision、Gemini 上传并分析图片,也支持通过多种端点"Chat with Files"。 |
| 上下文与会话管理能力强 | README 说明它支持保存、共享自定义 presets,聊天中切换 AI endpoint 和 preset,编辑、重发、继续消息,并支持 conversation branching、fork messages & conversations,这对长对话、多方案探索非常实用。 |
| 多语言、可恢复流、语音与导入导出 | 它提供多语言 UI,覆盖中文简繁、英文、日语、韩语、俄语、西语、法语等多种语言;支持 resumable streams,连接中断后可自动重连恢复;支持 speech-to-text / text-to-speech;还能导入来自 LibreChat、ChatGPT、Chatbot UI 的会话,并将会话导出为截图、markdown、text、json。 |
| 适合企业与多用户场景 | LibreChat 支持 OAuth2、LDAP、Email 登录,多用户安全访问,且内置 moderation 和 token spend 工具。README 还写到它可单机部署,也能借助 Redis 做水平扩展部署,并且能完全本地运行或部署到云端。 |

LibreChat 的安装和使用方法

1、安装

1)从仓库结构看,项目提供了完整的部署与配置入口

仓库文件列表里明确可见 Dockerfile、Dockerfile.multi、docker-compose.yml、docker-compose.override.yml.example、deploy-compose.yml、.env.example 和 librechat.example.yaml,说明它不是"只有前端源码",而是已经准备好 Docker、环境变量、部署编排和配置示例。

2)官方支持的部署方式

README 的 "Configuration & Deployment" 明确写到,它支持 Proxy、Reverse Proxy、Docker 以及 many Deployment options,并且可以 use completely local or deploy on the cloud。这意味着它的安装路径主要围绕容器化部署、本地私有部署和云部署展开。

3)配置方式

从仓库可见的 librechat.example.yaml 与 .env.example 看,LibreChat 的使用并不只是拉起容器,还需要按模型端点、认证方式、部署环境等进行配置。README 同时提示可以选择自定义 OpenAI-compatible endpoint、云端模型提供方或本地模型提供方。

2、使用方法

1 )多种后端与接口接入

在实际使用上,LibreChat 的入口是"先选模型,再选能力"。你可以选择 Anthropic、OpenAI、Azure OpenAI、Bedrock、Google、Vertex AI、OpenAI Responses API,或者自定义端点;再按需启用 Agents、Skills、MCP、搜索、文件、代码解释器、图像生成等功能。

2 )使用方式的核心思路

README 把它概括成 "All-In-One AI Conversations"。实际使用时,用户通常是在同一个聊天界面里完成:模型切换、会话继续、消息分支、文件上传分析、代码工件生成、图像生成/编辑、语音交互、会话搜索与导入导出。

3 )面向团队的使用路径

如果是团队场景,可以通过多用户认证、presets、agents marketplace、agent sharing、token spend tools、moderation 进行统一管理;如果是个人使用,则可以本地部署并按自己需要打开或关闭不同 AI provider 和工具模块。

LibreChat 的案例应用

1)把多个模型放在一个统一界面里用

LibreChat 最典型的应用,就是把 Claude、OpenAI、Azure OpenAI、Google、Vertex AI、Bedrock 以及本地模型放在同一个 UI 里,让用户不用在多个产品间切换。README 明确把"unifies all major AI providers in a single, privacy-focused interface"作为核心定位。

2)面向开发者的代码与原型工作流

借助 Code Interpreter、Code Artifacts、MCP、Skills、Subagents,LibreChat 很适合做开发辅助:例如写脚本、分析代码、生成 React/HTML/Mermaid 产物、把复杂任务拆给子代理执行。README 也把这些能力列为核心功能。

3)企业知识与多用户协作

由于它支持多用户认证、会话共享、Agent Marketplace、共享 presets、moderation 和 token spend 管理,所以很适合企业内部的知识问答、团队协作、角色化助手和权限控制。

4)文档、文件和多模态分析

LibreChat 支持"Chat with Files"、图片分析、会话导入导出,因此适合做文档审阅、图片理解、资料归档、会议记录整理、截图导出和知识沉淀。

5)联网检索增强问答

内置 Web Search、内容抓取、重排能力,使它很适合做需要实时信息的问答、研究辅助和资料汇总;README 还特别提到可自定义 Jina reranking 服务。

6)长对话与多端续接

resumable streams 和 multi-tab / multi-device sync 说明它适合长时间、跨设备、跨标签页的持续对话工作流,不容易因为断线丢失上下文。

7)图像生成与编辑场景

LibreChat 支持 text-to-image、image-to-image,以及多种图像模型或 MCP server,因此适合做创意草图、视觉内容生成、图片改写和快速设计辅助。