ghcr.io/danny-avila/librechat-api:v0.8.8-rc3

LibreChat

English · 中文

🚀 v0.8.8 版本新特性

• 代理管理 API（测试版）：支持创建、发现、更新、删除代理；管理代理文件与技能；通过与部署绑定的 OIDC 身份对机器客户端进行身份验证，同时保留现有角色与代理访问控制权限。公开的 OpenAPI 和 Swagger UI 覆盖推理、事件、代理管理与技能管理全场景。
• 关联工作区（高度实验性功能）：可为托管或个人代码工作器单独设置每个代理的默认工作区，之后代理可遍历目录树、读取并搜索文件、生成修改内容、在限定超时约束下运行 Bash。个人工作器支持受限自助注册、就绪状态展示，以及代理专属 Git 身份配置。
• 后台工具控制：可选择取消常规后台工具任务，包括关联的 Bash 任务，同时不影响独立运行的分离式子代理执行流程。
• 代码审批控制：管理员授权后，可针对文件写入和命令执行选择「询问」「允许」或「拒绝」权限策略，针对可信关联环境还提供完全访问模式。文件搜索和代码运行能力也遵循角色授权规则。
• 手动上下文压缩：在上下文窗口占满前启动仅摘要轮次，同时根据部署的摘要策略保留近期对话内容。
• 上下文用量统计：可查看对话内容、已保留工具流量、代理指令、缓存、成本与运行空间压力统计，不会对分类子集重复计数。
• 统一附件机制：只需上传一次，LibreChat 即可自动将内容路由至模型或提取文本，仅在需要时自动配置文件搜索与代码工具。
• 模型支持：新增 GPT-6 Astra 和 GPT-6.1 Sol 模型，支持 Responses API 路由与工具调用。
• 代理与聊天 UI：统一展示工具活动、推理过程、搜索内容与代理工作流；为聊天与收藏项新增可拖拽的置顶区域，更新动态状态图标，新增高对比度主题，支持富文本消息复制，优化侧边栏标题清晰度，改良实时阶段布局。
• 可观测性能力：可在追踪查看器中查看按顺序排列的模型对话、工具轮次与成本数据；可通过 OpenTelemetry 导出关联的应用日志，配置已列入白名单的 Langfuse 追踪身份与元数据，为浏览器诊断信息添加客户端构建 ID 标签，并将 Insights 数据范围限定为授权代理可见。
• 可靠性与安全性增强：强化代理续跑与检查点恢复能力，新增 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 使用 LibreChat，无需额外代理
• 兼容本地与远程 AI 服务提供商：Ollama、AMD Lemonade、groq、Cohere、Mistral AI、Apple MLX、koboldcpp、together.ai、OpenRouter、Helicone、Perplexity、ShuttleAI、Deepseek、通义千问等

🔧 代码解释器 API：

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

🔦 代理与工具集成：

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

• 无代码自定义助手：构建由 AI 驱动的专用助手
• 代理市场：发现并部署社区贡献的代理
• 协作共享：将代理分享给指定用户和用户组
• 灵活可扩展：支持使用 MCP 服务器、工具、文件搜索、代码执行等能力
• 技能：创建可复用的 SKILL.md 指令包，用于手动、自动或常驻式代理工作流
• 代理插件：实验性功能，可将部署技能与 MCP 服务器打包为随启动加载的包
• 子代理：可将细分任务委派给独立运行的子代理，子代理拥有独立上下文窗口
• 代理管理 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 服务器实现文生图
• 可通过提示词生成精美图像，或通过单条指令优化已有图像

---

💾 预设与上下文管理

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

---

💬 多模态与文件交互

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

---

🌎 多语言界面

• 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、ไทย、ئۇيغۇرچە

---

🧠 推理界面

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

---

🎨 可自定义界面

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

---

📈 可观测性

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

---

🌊 可恢复流式输出

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

---

🗣️ 语音与音频

• 通过语音转文字与文字转语音功能实现免手持聊天

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

• 兼容 OpenAI、Azure OpenAI 和 Elevenlabs

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

• 自动发送并播放音频

• 支持 OpenAI、Azure OpenAI 与 Elevenlabs

📥 对话导入与导出：

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

🔍 搜索与查找：

• 可在全部消息/对话范围内执行搜索

👥 多用户与安全访问：

• 多用户场景下支持通过 OAuth2、LDAP 与***登录实现安全身份认证
• 内置内容审核功能与 Token 消耗统计工具

🎛️ 管理员面板：

• 基于浏览器的 UI 界面，可管理用户、用户组、角色以及配置覆盖规则
• 无需重新部署即可实时编辑设置与各角色/用户组的权限
• 已集成至 Docker Compose 编排栈中，支持单命令一键部署

⚙️ 配置与部署：

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

📖 开源与社区：

• 完全开源，全开发过程公开透明
• 由社区驱动开发、提供支持并收集反馈

如需全面了解所有功能，请查阅我们的官方文档 📚

🪶 LibreChat：一站式 AI 对话平台

LibreChat 是一款自托管 AI 聊天平台，所有主流 AI 服务商都可集成至同一个以隐私保护为核心的界面中。

除基础聊天能力外，LibreChat 还提供 AI 智能体、Model Context Protocol (MCP) 支持、项目产物（Artifacts）、代码解释器、自定义动作、对话搜索以及企业级多用户身份认证能力。

它完全开源且处于活跃开发状态，专为所有希望自主掌控 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 指令、缓存占用、消耗成本与剩余可用 Token 容量，不会对分类子集内容重复计数。
• 统一附件机制： 附件只需上传一次，LibreChat 会自动将内容路由至模型或提取文本，仅在实际需要时才自动启用文件搜索与代码工具能力。
• 模型支持： 新增 GPT-6 Astra 与 GPT-6.1 Sol 模型，支持 Responses API 路由与工具调用能力。
• Agent 与聊天 UI： 统一整合工具活动状态、推理过程、搜索行为与 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）
  • 自定义端点：可直接在 LibreChat 中使用任何兼容 OpenAI 规范的 API，无需额外代理
  • 兼容以下本地与远程 AI 服务提供商： Ollama、AMD Lemonade、groq、Cohere、Mistral AI、Apple MLX、koboldcpp、together.ai、 OpenRouter、Helicone、Perplexity、ShuttleAI、Deepseek、通义千问等更多服务商

• 🔧 代码解释器 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：

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

• 🧠 推理专属 UI：

  • 为 DeepSeek-R1 等思维链/深度推理类 AI 模型提供动态适配的推理展示界面

• 🎨 可自定义界面：

  • 下拉菜单与全界面可自定义，同时适配高阶用户与新手用户的使用习惯
  • 支持浅色、深色、跟随系统、高对比度四种外观模式

• 📈 可观测性：

  • 可通过 OpenTelemetry 导出链路追踪与日志数据，对接 Langfuse 获取智能体与模型运行的全链路洞察

• 🌊 可恢复流式输出：

  • 不会丢失响应内容：网络中断后 AI 响应会自动重连并从断点处继续输出
  • 多标签页与多设备同步：可在多个标签页中打开同一场对话，也可切换到其他设备继续操作
  • 生产级可靠性：从单服务器部署到接入 Redis 的水平扩展集群均可稳定运行

• 🗣️ 语音与音频功能：

  • 支持语音转文字、文字转语音，实现免手动语音对话
  • 支持自动发送语音输入、自动播放语音输出
  • 兼容 OpenAI、Azure OpenAI、Elevenlabs 语音接口

• 📥 对话导入导出：

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

• 🔍 全局检索功能：

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

• 👥 多用户与安全访问：

  • 多用户环境，支持 OAuth2、LDAP、***登录等安全身份认证方式
  • 内置内容审核与 Token 消耗统计工具

• 🎛️ 管理后台：

  • 基于浏览器的可视化管理界面，可管理用户、用户组、角色与配置覆盖规则
  • 无需重新部署即可实时修改系统设置与各角色/用户组的权限
  • 与 Docker Compose 部署栈深度整合，单命令即可完成部署启用

• ⚙️ 配置与部署选项：

  • 支持配置代理、反向代理、Docker 等多种部署模式
  • 可接入搭配 CloudFront 的 S3 存储，获得稳定媒体链接、边缘分发、签名 Cookie 与安全下载能力
  • 支持完全本地私有化部署或云上部署

• 📖 开源与社区：

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

如需完整的功能说明，请访问官方文档 📚

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

LibreChat 是一款自托管 AI 对话平台，可在同一个以隐私为核心的界面中整合所有主流 AI 服务提供商。 除基础对话功能外，LibreChat 还提供 AI 智能体、Model Context Protocol (MCP) 支持、代码构件、代码解释器、自定义动作、对话检索，以及企业级多用户身份认证能力。 项目完全开源、持续迭代，专为所有希望自主掌控 AI 基础设施的用户打造。

---

🌐 相关资源

镜像名称：ghcr.io/danny-avila/librechat-api 参考标签：latest

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] 在执行升级操作前，请务必查阅更新日志，确认是否存在会影响现有部署的不兼容变更。

---

⭐ Star 增长历史

---

✨ 贡献指南

我们欢迎所有形式的项目贡献，包括功能建议、问题反馈、漏洞修复！

如果你计划提交新功能、新增组件或扩展特性，请先提交 Issue 与社区讨论方案，确认可行性后再发起 Pull Request。

如果你愿意协助将 LibreChat 翻译为你的母语，我们非常欢迎你的加入。完善多语言翻译不仅能让全球更多用户便捷使用 LibreChat，也能显著提升整体使用体验。你可以查阅我们的翻译指南了解参与方式。

---

💖 本项目能达到当前状态，离不开所有贡献者的付出

---

🎉 特别鸣谢

感谢 Locize 为 LibreChat 提供的多语言翻译管理工具支持。