huggingface/chat-ui

这是什么？

核心功能

• 01通过 OPENAI_BASE_URL 对接任意 OpenAI 兼容 API。
• 02从接口的 /models 端点自动发现可用模型。
• 03使用 MongoDB 保存聊天记录和设置，本地开发时可回退到内嵌实例。
• 04支持通过 MCP 服务器进行基于 OpenAI 函数调用的工具调用。
• 05提供可选的 Omni 路由，按消息选择合适的模型。
• 06可通过环境变量自定义应用名称、素材和描述。

适用场景

• 为自托管的 llama.cpp 或 Ollama 服务搭建类 ChatGPT 的聊天界面。
• 为使用 OpenAI 兼容网关的团队搭建内部聊天前端。
• 基于 SvelteKit 和 MongoDB 开发自定义聊天应用的起点。
• 在同一聊天界面中使用不同模型测试 MCP 工具。

快速上手

1. 1

   克隆仓库

   git clone https://github.com/huggingface/chat-ui
2. 2

   进入项目目录

   cd chat-ui
3. 3

   安装依赖

   npm install
4. 4

   启动开发服务器并打开浏览器（需先创建包含 OPENAI_BASE_URL 和 OPENAI_API_KEY 的 .env.local）

   npm run dev -- --open

使用前须知

• !仅支持 OpenAI 兼容的 API，已移除特定厂商的集成。
• !需要自备 API 端点和密钥，例如 Hugging Face 令牌或本地 llama.cpp、Ollama 服务。
• !聊天记录和设置需要 MongoDB；未设置连接地址时会使用内置的嵌入式数据库。

标签

常见问题

chat-ui 是什么？

基于 SvelteKit 的大模型聊天界面，可对接任意 OpenAI 兼容接口，也是 HuggingChat 的底层代码。 Chat UI 是一个面向大语言模型的网页聊天界面，使用 SvelteKit 和 TypeScript 构建。它是 hf.co/chat 上 HuggingChat 应用的代码基础，既可以本地运行，也可以自行部署到自己的模型服务上。

chat-ui 可以免费使用吗？用的什么许可证？

chat-ui 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

chat-ui 还在维护吗？

活跃维护中。chat-ui 最近一次提交是在 2026年10月20日。

chat-ui 适合用来做什么？

为自托管的 llama.cpp 或 Ollama 服务搭建类 ChatGPT 的聊天界面。 为使用 OpenAI 兼容网关的团队搭建内部聊天前端。 基于 SvelteKit 和 MongoDB 开发自定义聊天应用的起点。 在同一聊天界面中使用不同模型测试 MCP 工具。

chat-ui 怎么安装和运行？

克隆仓库: git clone https://github.com/huggingface/chat-ui 进入项目目录: cd chat-ui 安装依赖: npm install 启动开发服务器并打开浏览器（需先创建包含 OPENAI_BASE_URL 和 OPENAI_API_KEY 的 .env.local）: npm run dev -- --open

在哪里获取 chat-ui？

源代码和安装说明在 GitHub 上：https://github.com/huggingface/chat-ui