ghcr.io/danny-avila/librechat-dev:c8c5478cf1aad413fd398eb80d551eaa7d7d7721

LibreChat

English · 中文

🚀 v0.8.8 版本新特性

• Agent 管理 API（测试版）：支持创建、查找、更新、删除 Agent；管理 Agent 文件与技能；可通过绑定部署环境的 OIDC 身份对机器客户端进行身份验证，同时保留现有角色与 Agent 访问控制机制。公开的 OpenAPI 文档与 Swagger UI 覆盖推理、事件、Agent 管理、技能管理全流程。
• 关联工作区（高度实验性）：可绑定或保存每个托管/个人代码工作器对应的 Agent 默认工作区，支持 Agent 遍历目录树、读取和搜索文件、编写修改内容、在限定超时时间内运行 Bash 命令。个人工作器支持限定范围的自助注册、就绪状态管理，以及单 Agent 专属 Git 身份配置。
• 后台工具控制：可选择终止普通后台工具任务，包括关联的 Bash 进程，同时保证独立子 Agent 的执行过程不受影响。
• 代码审批控制：在管理员允许的范围内，可对文件写入和命令执行操作选择「询问」、「允许」或「拒绝」权限，针对可信关联环境还提供完全访问模式。文件搜索和代码运行功能也完全遵循角色权限配置。
• 手动上下文压缩：可在上下文窗口占满前启动仅摘要模式的会话回合，系统会按照部署预设的摘要策略保留近期对话内容。
• 上下文用量统计：可查看对话内容、已保留的工具调用数据、Agent 提示词、缓存、成本与配额压力，不会出现分类子集重复计数的问题。
• 统一附件机制：一次上传文件后，LibreChat 会自动将内容路由给模型或提取文本内容，仅在实际需要时才启用文件搜索与代码工具。
• 模型支持：新增 GPT-6 Astra 与 GPT-6.1 Sol 模型，提供 Responses API 路由与工具调用支持。
• Agent 与聊天界面升级：统一展示工具活动、推理过程、搜索结果与 Agent 工作流；新增支持拖拽的聊天与收藏固定区、动态状态图标、高对比度主题、富文本消息复制功能，优化了侧边栏标题可读性与实时执行阶段的页面布局。
• 可观测性能力：可在追踪查看器中按顺序检查模型对话、工具调用轮次与消耗成本；支持通过 OpenTelemetry 导出关联的应用日志，配置白名单放行的 Langfuse 追踪身份与元数据，为浏览器诊断数据添加客户端构建 ID 标记，且可将洞察数据的访问范围限定为已授权 Agent。
• 可靠性与安全性增强：强化了 Agent 续跑与检查点恢复能力，优化了 Redis 活性检测、DocumentDB 协调机制、OpenID 与 MCP OAuth 会话管理、共享链接限流、租户隔离、附件大小限制与上传错误处理逻辑。 阅读完整 v0.8.8 更新日志。

✨ 核心功能

• 🖥️ UI 与交互体验：参考 *** 设计并进行了增强优化

• 🤖 AI 模型选择：

  • Anthropic（Claude）、AWS Bedrock、OpenAI、Azure OpenAI、Google、Vertex AI、OpenAI Responses API（含 Azure 版本）
  • 自定义端点：可接入任何兼容 OpenAI 接口的 API，无需额外代理
  • 兼容各类本地与远程 AI 服务商：Ollama、AMD Lemonade、groq、Cohere、Mistral AI、Apple MLX、koboldcpp、together.ai、OpenRouter、Helicone、Perplexity、ShuttleAI、Deepseek、通义千问（Qwen）等

• 🔧 Code Interpreter API：

  • 提供安全沙箱执行环境，支持 Python、Node.js（JS/TS）、Go、C/C++、Java、PHP、Rust 与 Fortran
  • 无缝文件交互：支持直接上传、处理、下载文件
  • 无隐私风险：运行环境完全隔离，安全性有保障
  • 开源可自托管：基于 ClickHouse/code-interpreter 项目构建

• 🔦 Agent 与工具集成： LibreChat Agent：无需编码即可构建专属自定义助手，打造专用 AI 服务 Agent 市场：可发现并部署社区贡献的 Agent 资源 协作分享：可将 Agent 定向分享给指定用户与用户组 灵活可扩展：支持接入 MCP 服务器、各类工具、文件搜索、代码执行等能力 技能机制：可创建可复用的 SKILL.md 指令包，支持手动、自动或常驻模式的 Agent 工作流 Agent 插件（实验性）：可将部署技能与 MCP 服务器打包为启动时自动加载的安装包 子 Agent 机制：可将细分任务分配给拥有独立上下文窗口的隔离子 Agent 运行 Agent 管理 API：通过绑定部署环境的 OIDC 客户端自动完成 Agent、文件与技能的全生命周期管理 关联代码工作区（高度实验性）：允许 Agent 在托管或个人专属工作区中遍历、搜索、编辑文件并执行命令 兼容自定义端点、OpenAI、Azure、Anthropic、AWS Bedrock、Google、Vertex AI、Responses API 等所有支持的模型平台，支持 Model Context Protocol（MCP）工具接入

LibreChat 代理：无代码自定义助手

• 无代码自定义助手：构建由 AI 驱动的专用辅助工具
• 代理市场：发现并部署社区创建的代理
• 协作共享：与指定用户和用户组共享代理
• 灵活可扩展：支持使用 MCP Server、工具、文件搜索、代码执行等能力
• 技能：创建可复用的 SKILL.md 指令包，用于手动、自动或常驻式代理工作流
• 代理插件：将部署技能与 MCP Server 实验性捆绑为启动时自动加载的包
• 子代理：将聚焦任务委派给独立运行的子代理，子代理拥有专属上下文窗口
• 代理管理 API：通过绑定部署的 OIDC 客户端自动完成代理、文件和技能的管理
• 附加代码工作区：允许代理在托管或个人工作区中检查、搜索、编辑文件并运行命令（高度实验性功能）
• 兼容 Custom Endpoints、OpenAI、Azure、Anthropic、AWS Bedrock、Google、Vertex AI、Responses API 等多种服务
• 支持基于 Model Context Protocol (MCP) 的工具

🔍 网页搜索

• 搜索互联网并获取相关信息，扩充 AI 上下文
• 整合搜索提供者、内容爬取器与结果重排序器，输出最优结果
• 可自定义 Jina 重排序：为重排序服务配置自定义 Jina API 地址
• 了解更多 →

🪄 代码构件生成式 UI

• 代码构件可直接在聊天中生成 React、HTML 和 Mermaid 内容
• 支持全屏打开预览，可将 Mermaid 图表导出为 SVG 或 PNG 格式

🎨 图像生成与编辑

• 支持通过 GPT-Image-1 实现文生图与图生图
• 支持通过 DALL-E (3/2)、Stable Diffusion、Flux 或任意 MCP Server 实现文生图
• 既可基于提示词生成精美图像，也可单指令完成现有图像的优化

💾 预设与上下文管理

• 创建、保存并分享自定义预设
• 聊天过程中可随时切换 AI 端点与预设
• 通过对话分支功能编辑、重新提交和接续消息
• 创建提示词并与指定用户、用户组共享
• 支持分叉消息与对话，实现高级上下文控制
• 可按需压缩长对话，同时保留近期上下文

💬 多模态与文件交互

• 支持使用 Claude 3、GPT-4.5、GPT-4o、o1、Llama-Vision、Gemini 上传并分析图像
• 支持通过 Custom Endpoints、OpenAI、Azure、Anthropic、AWS Bedrock、Google 与文件对话
• 可将消息复制为带格式的富文本，直接用于文档、邮件与协作应用

🌎 多语言 UI

• English、中文 (简体)、中文 (繁體)、العربية、Deutsch、Español、Français、Italiano
• Polski、Português (PT)、Português (BR)、Русский、日本語、Svenska、한국어、Tiếng Việt
• Türkçe、Nederlands、עברית、Català、Čeština、Dansk、Eesti、فارسی
• Suomi、Magyar、Հայերեն、Bahasa Indonesia、ქართული、Latviešu、ไทย、ئۇيغۇرچە

🧠 推理 UI

• 为 DeepSeek-R1 等支持思维链/推理的 AI 模型提供动态推理 UI

🎨 可自定义界面

• 适配高级用户与新用户的自定义下拉菜单与交互界面
• 提供浅色、深色、跟随系统、高对比度四种外观模式

📈 可观测性

• 通过 OpenTelemetry 导出链路与日志，可接入 Langfuse 获取代理与模型运行洞察

🌊 可恢复数据流

• 永不丢失响应：网络中断时 AI 响应会自动重连并继续生成
• 多标签页与多设备同步：可在多个标签页打开同一聊天，或切换到其他设备接续对话
• 生产就绪：支持从单服务器部署到搭载 Redis 的水平扩展集群部署

🗣️ 语音与音频

• 借助语音转文字与文字转语音能力实现免手持聊天

• 支持自动发送与播放音频

• 兼容 OpenAI、Azure OpenAI 与 Elevenlabs 服务

• 借助语音转文本与文本转语音功能实现免手动对话

• 自动发送并播放音频

• 支持 OpenAI、Azure OpenAI 与 Elevenlabs

• 📥 对话导入与导出：支持从 LibreChat、***、Chatbot UI 导入对话，可将对话导出为截图、Markdown、纯文本、JSON 格式

📥 对话导入与导出

• 从 LibreChat、***、Chatbot UI 导入对话
• 将对话导出为截图、Markdown、纯文本、JSON 格式
• 🔍 搜索与发现：支持搜索所有消息与对话

🔍 搜索与发现

• 搜索全部消息与对话
• 👥 多用户与安全访问：多用户支持，内置 OAuth2、LDAP 与***登录的安全认证，自带内容审核与 Token 消耗管控工具

👥 多用户与安全访问

• 多用户场景支持，通过 OAuth2、LDAP 与***登录实现安全认证
• 内置内容审核功能与 Token 消耗管控工具
• 🎛️ 管理面板：基于浏览器的 UI 界面，可管理用户、用户组、角色与配置覆盖项；无需重新部署即可实时编辑设置与各角色/用户组权限；已随 Docker Compose 编排包一并提供，支持单命令完成部署

🎛️ 管理面板

• 基于浏览器的 UI 界面，用于管理用户、用户组、角色与配置覆盖项
• 无需重新部署，即可实时编辑设置与各角色/用户组权限
• 已集成到 Docker Compose 部署栈中，支持单命令完成部署
• ⚙️ 配置与部署：支持配置代理、反向代理、Docker 及多种部署选项；搭配 S3 与 CloudFront 使用可获得稳定的媒体链接、边缘分发、签名 Cookie 与安全下载能力；既可以完全本地部署，也可以部署在云端

⚙️ 配置与部署

• 支持配置代理、反向代理、Docker 及多种部署方案
• 搭配 S3 与 CloudFront 使用，可获得稳定媒体链接、边缘分发、签名 Cookie 与安全下载能力
• 支持完全本地运行或云端部署
• 📖 开源与社区：完全开源，全流程公开开发；由社区驱动开发、提供支持与反馈

📖 开源与社区

• 项目完全开源，所有开发过程公开可见
• 由社区驱动开发、提供支持与反馈

如需全面了解所有功能，请点击此处查阅我们的文档 📚

🪶 LibreChat：一站式 AI 对话平台

LibreChat 是一款自托管 AI 对话平台，可将所有主流 AI 服务商整合到单一、以隐私为核心的界面中。

除基础对话能力外，LibreChat 还提供 AI 代理、Model Context Protocol（MCP）支持、工件、代码解释器、自定义动作、对话搜索以及企业级多用户认证功能。

项目开源、持续迭代，专为所有希望自主掌控 AI 基础设施的用户打造。

🌐 相关资源

GitHub 仓库：

• RAG API：github.com/LibreChat-AI/rag-api
• 官网：github.com/LibreChat-AI/librechat.ai 其他资源：
• 官网：librechat.ai
• 文档：librechat.ai/docs
• 博客：librechat.ai/blog

📝 更新日志

你可以访问发布页面与更新说明跟进最新动态：

• 发布版本
• 更新日志

[!WARNING] 更新前请务必查阅更新日志，确认是否存在不兼容的破坏性变更。

⭐ Star 历史

✨ 贡献指南

我们欢迎任何形式的贡献、建议、问题反馈与代码修复！

如果你要新增功能、组件或扩展功能，请先提交 Issue 进行讨论，之后再提交 PR。

如果你有意协助将 LibreChat 翻译为你的母语，我们非常欢迎你的贡献！优化翻译不仅能让更多地区的用户更方便地使用 LibreChat，还能全面提升用户体验。你可以查看我们的[翻译指南]获取更多信息。

💖 项目致谢

本项目当前的形态离不开所有贡献者的付出。

🎉 特别鸣谢

感谢 Locize 提供的翻译管理工具，该工具支持 LibreChat 中的多语言能力实现。

---

项目仓库 README（补充说明）

LibreChat

English · 中文

🚀 v0.8.8 版本新特性

• Agent 管理 API（测试版）： 支持创建、查看、更新、删除 Agent；管理 Agent 文件与技能；通过与部署绑定的 OIDC 身份对机器客户端进行身份验证，同时保留现有角色与 Agent 访问控制规则。公开的 OpenAPI 与 Swagger UI 覆盖推理、事件、Agent 管理、技能管理全场景。
• 关联工作区（高度实验性）： 可为每个托管或个人代码工作器选择或设置独立的 Agent 默认工作区，之后 Agent 可查看目录树、读取与搜索文件、编写修改内容，并在限定超时范围内运行 Bash 命令。个人工作器支持自助式注册、就绪状态管理与单 Agent Git 身份配置。
• 后台工具控制： 可选择性取消正在运行的普通后台工具（包括关联 Bash 进程），同时保持独立运行的子 Agent 进程不受影响。
• 代码审批控制： 管理员可设置文件写入与命令执行的权限选项，包括「询问」「允许」「拒绝」三种模式，针对受信任的关联环境还提供「完全访问」模式；文件搜索与代码运行功能也严格遵循角色权限配置。
• 手动上下文压缩： 可在上下文窗口占满前启动仅摘要模式的对话轮次，根据部署预设的摘要策略保留近期对话内容，避免上下文溢出。
• 上下文用量统计： 可查看对话内容、已保留的工具流量、Agent 指令、缓存、成本与资源占用压力，不会对分类子集进行重复统计。
• 统一附件处理： 附件仅需上传一次，LibreChat 会自动将内容路由到对应模型或提取为文本，仅在需要时才为其分配文件搜索与代码工具权限。
• 新增模型支持： 新增 GPT-6 Astra 与 GPT-6.1 Sol 模型，支持 Responses API 路由与工具调用。
• Agent 与对话界面升级： 统一展示工具活动、推理过程、搜索结果与 Agent 工作流；新增可拖拽的固定区域，用于存放对话与收藏内容；优化动态状态图标、高对比度主题、富文本消息复制功能、更清晰的侧边栏标题，以及更合理的实时流程布局。
• 可观测性增强： 可在追踪查看器中按顺序查看模型对话、工具调用轮次与消耗；通过 OpenTelemetry 导出关联的应用日志；支持配置白名单内的 Langfuse 追踪身份与元数据，为浏览器诊断信息标记客户端构建 ID，并将数据洞察限定在已授权 Agent 范围内。
• 可靠性与安全性加固： 强化 Agent 续跑与检查点恢复能力、Redis 存活检测、DocumentDB 协调机制、OpenID 与 MCP OAuth 会话管理、共享链接限流、租户隔离、附件大小限制与上传错误处理逻辑。

请查阅 完整 v0.8.8 更新日志 了解详情。

✨ 功能特性

• 🖥️ 界面与使用体验 借鉴 *** 设计风格，同时提供了增强的交互设计与扩展功能

• 🤖 AI 模型选择：

  • 支持 Anthropic (Claude)、AWS Bedrock、OpenAI、Azure OpenAI、Google、Vertex AI、OpenAI Responses API（含 Azure 版本）
  • 自定义端点：可直接对接任何兼容 OpenAI 规范的 API，无需额外代理
  • 兼容以下本地与远程 AI 服务商：
    • Ollama、AMD Lemonade、groq、Cohere、Mistral AI、Apple MLX、koboldcpp、together.ai
    • OpenRouter、Helicone、Perplexity、ShuttleAI、Deepseek、通义千问（Qwen）等更多平台

• 🔧 Code Interpreter API：

  • 支持 Python、Node.js（JS/TS）、Go、C/C++、Java、PHP、Rust、Fortran 多语言安全沙箱执行
  • 无缝文件处理：直接上传、处理、下载文件
  • 无隐私风险：执行环境完全隔离、安全可靠
  • 开源且支持自托管：基于 https://github.com/ClickHouse/code-interpreter 提供能力

• 🔦 智能体与工具集成：

  • LibreChat 智能体：
    • 低代码自定义助手：快速搭建专业化 AI 辅助工具
    • 智能体市场：一键发现并部署社区贡献的智能体
    • 协作分享：可向指定用户或用户组分享自定义智能体
    • 灵活可扩展：支持接入 MCP 服务器、各类工具、文件搜索、代码执行等能力
  • 技能（Skills）：创建可复用的 SKILL.md 指令包，支持手动、自动、常驻三类智能体工作流
  • 智能体插件：实验性功能，可将部署好的技能与 MCP 服务器打包为随启动自动加载的功能包
  • 子智能体：可将聚焦的细分任务委派给拥有独立上下文窗口的隔离子智能体运行
  • 智能体管理 API：可通过部署绑定的 OIDC 客户端自动完成智能体、文件、技能的全生命周期管理
  • 绑定代码工作区：（高度实验性功能）允许智能体在托管或个人工作区内查看、搜索、编辑文件并执行命令
  • 兼容自定义端点、OpenAI、Azure、Anthropic、AWS Bedrock、Google、Vertex AI、Responses API 等主流服务
  • 提供https://modelcontextprotocol.io/clients#librechat

• 🔍 网页搜索：

  • 实时联网搜索获取相关信息，为 AI 对话补充额外上下文
  • 整合多搜索源、内容抓取器、结果重排器，输出最优结果
  • 可自定义 Jina 重排序：支持配置自定义 Jina API 地址对接重排序服务
  • 了解更多 →

• 🪄 带代码构件的生成式 UI：

  • 代码构件 支持在聊天界面内直接生成 React、HTML、Mermaid 格式内容
  • 支持全屏预览效果，还可将 Mermaid 图表导出为 SVG 或 PNG 格式

• 🎨 图像生成与编辑

  • 基于 GPT-Image-1 实现文生图、图生图能力
  • 支持通过提示词生成精美视觉内容，或单条指令即可优化已有图片

• 💾 预设与上下文管理：

  • 创建、保存、分享自定义预设配置
  • 支持在对话中途随时切换 AI 端点与预设
  • 可编辑、重提交、续发消息，搭配对话分支功能灵活调整流程
  • 支持创建提示词并分享给指定用户或用户组
  • 复刻消息与对话，实现精细化上下文控制
  • 按需压缩长对话内容，同时保留近期关键上下文

• 💬 多模态与文件交互：

  • 支持 Claude 3、GPT-4.5、GPT-4o、o1、Llama-Vision、Gemini 等模型上传并分析图片 📸
  • 支持通过自定义端点、OpenAI、Azure、Anthropic、AWS Bedrock、Google 服务对接实现文件对话 🗃️
  • 可将消息复制为带格式的富文本，直接用于文档、邮件和协作应用

• 🌎 多语言 UI：

  • 支持 英语、简体中文、繁體中文、阿拉伯语、德语、西班牙语、法语、意大利语
  • 波兰语、葡萄牙语（葡萄牙）、葡萄牙语（巴西）、俄语、日语、瑞典语、韩语、越南语
  • 土耳其语、荷兰语、希伯来语、加泰罗尼亚语、捷克语、丹麦语、爱沙尼亚语、波斯语
  • 芬兰语、匈牙利语、亚美尼亚语、印度尼西亚语、格鲁吉亚语、拉脱维亚语、泰语、维吾尔语

• 🧠 推理展示界面：

  • 为 DeepSeek-R1 等思维链/推理类 AI 模型提供动态推理过程展示界面

• 🎨 可自定义界面：

  • 可自定义下拉菜单与交互界面，同时适配专业用户与新手用户使用习惯
  • 提供浅色、深色、跟随系统、高对比度四种外观模式

• 📈 可观测性：

  • 支持通过 OpenTelemetry 导出链路追踪与日志，可对接 Langfuse 查看智能体与模型运行洞察

• 🌊 可恢复流式输出：

  • 不会丢失任何 AI 响应：网络中断后自动重连并恢复生成内容
  • 多标签页与多设备同步：可在多个标签页打开同一场对话，也可切换到其他设备继续使用
  • 生产级可靠性：既支持单服务器部署，也可搭配 Redis 实现水平扩展集群部署

• 🗣️ 语音与音频：

  • 支持语音转文字、文字转语音，实现免手持对话
  • 支持自动发送与播放音频内容
  • 兼容 OpenAI、Azure OpenAI、Elevenlabs 语音服务

• 📥 对话导入导出：

  • 支持从 LibreChat、***、Chatbot UI 导入历史对话
  • 支持将对话导出为截图、Markdown、纯文本、JSON 格式

• 🔍 全局搜索与发现：

  • 支持全文检索所有消息与历史对话

• 👥 多用户与安全访问：

  • 多用户安全认证，支持 OAuth2、LDAP、***登录方式
  • 内置内容审核与 Token 用量管控工具

• 🎛️ 管理员面板：

  • 基于浏览器的可视化界面，可直接管理用户、用户组、角色与配置覆盖项
  • 无需重新部署，即可在线实时修改设置与各角色/用户组的权限
  • 已内置在 Docker Compose 部署栈中，单命令即可完成配置启动

• ⚙️ 配置与部署：

  • 支持配置代理、反向代理、Docker 等多种部署方案
  • 可搭配 S3 + CloudFront 使用，实现稳定媒体链接、边缘分发、签名 Cookie 与安全下载
  • 既支持完全本地部署，也支持上架到云平台部署

• 📖 开源与社区：

  • 项目完全开源，全开发过程公开透明
  • 采用社区驱动模式，提供持续迭代的开发、支持与反馈通道

如需完整浏览全部功能说明，请查阅官方文档 📚

---

🪶 基于 LibreChat 实现一站式 AI 对话体验

LibreChat 是一款自托管 AI 聊天平台，可将所有主流 AI 服务商能力统一整合到一个注重隐私的界面中。

除基础对话能力外，LibreChat 还提供 AI 智能体、模型上下文协议（MCP）支持、代码构件、代码解释器、自定义动作、对话搜索，以及符合企业级标准的多用户认证体系。

项目完全开源、持续迭代，专为所有想要自主掌控 AI 基础设施的用户打造。

---

🌐 相关资源

GitHub 代码仓库：

• RAG API: https://github.com/LibreChat-AI/rag-api
• 官方网站仓库: https://github.com/LibreChat-AI/librechat.ai

其他资源：

• 官方网站: librechat.ai
• 文档中心: librechat.ai/docs
• 官方博客: librechat.ai/blog

---

📝 更新日志

你可以访问以下发布页面和日志页面，获取最新的功能更新信息：

• https://github.com/LibreChat-AI/LibreChat/releases
• 更新日志页

[!WARNING] 在执行版本升级前，请务必查阅更新日志，确认是否存在不兼容的破坏性变更。

---

⭐ 星标增长历史

---

✨ 贡献指南

欢迎提交代码、功能建议、Bug 反馈和修复补丁！

如果你计划新增功能、组件或扩展特性，请先提交 Issue 与社区讨论确认后，再发起 PR 提交代码。

如果你愿意协助将 LibreChat 翻译为你的母语，我们非常欢迎这类贡献。翻译质量的提升不仅能让全球更多用户顺畅使用 LibreChat，还能优化整体使用体验，请查阅我们的翻译指南了解详情。

---

💖 本项目当前的成熟形态离不开所有贡献者的付出

---

🎉 特别鸣谢

感谢 Locize 提供的翻译管理工具，它为 LibreChat 的多语言能力提供了有力支撑。