chat-ui

一键部署类ChatGPT界面，快速接入你的LLM模型

chat-ui 是 Hugging Face 官方开源的对话助手前端代码库，支撑 HuggingChat 产品运行。它基于 SvelteKit 和 TypeScript 构建，采用 Tailwind CSS 实现界面样式。该项目解决的核心问题是：为开发者提供一个开箱即用、可高度定制的 LLM 对话界面，无需从零搭建前端。它支持接入 Hugging Face 的 Inference API 或 OpenAI 兼容接口，内置多模型切换、流式响应、对话历史管理、Markdown 渲染等核心能力，并集成了 Web Search、代码高亮等实用功能。通过简单的环境变量配置，开发者即可快速部署自己的聊天机器人，并可通过修改组件和样式实现个性化。项目代码结构清晰，社区活跃，适合作为生产级对话应用的起点。

开源 freemium 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 10957

维护状态活跃

是否开源是

定价模式 freemium

项目数据

分类对话助手

开发团队huggingface

所属国家

官网地址

GitHubhttps://github.com/huggingface/chat-ui

定价模式freemium

价格说明HuggingChat 提供免费在线聊天服务，部分高级功能或模型可能需要付费或订阅，具体以官网为准。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型chatgpt,hacktoberfest,huggingface,llm,svelte,svelte-kit,sveltekit,tailwindcss,typescript

GitHub 星标★ 10957

30天Star增速

HF 下载量

上线时间2023-02-17 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 5 步

环境要求

Node.js 与 npm（README 使用 npm install / npm run dev）
git（克隆仓库用）
一个 OpenAI 兼容 API 的地址与密钥（如 Hugging Face 路由、llama.cpp、Ollama、OpenRouter、Poe）
可选：Docker，用于运行内置 MongoDB 的 chat-ui-db 镜像

安装与启动步骤

1克隆仓库

把 chat-ui 源码拉到本地，README 给出的官方仓库地址如下。
```
git clone https://github.com/huggingface/chat-ui
```
2安装依赖

进入项目目录并安装 npm 依赖，首次安装耗时较长。
```
cd chat-ui
npm install
```
3配置接口密钥

在项目根目录新建 .env.local，写入 OPENAI_BASE_URL 与 OPENAI_API_KEY 两行。密钥用你自己服务商提供的值。
4启动开发服务器

运行 dev 脚本并自动打开浏览器，本地即可开始对话。
```
npm run dev -- --open
```

5可选 Docker 运行

chat-ui-db 镜像内置 MongoDB，用 -v 挂载数据卷持久化，端口映射到 3000。

docker run -p 3000:3000 -e OPENAI_BASE_URL=https://router.huggingface.co/v1 -e OPENAI_API_KEY=hf_xxxxxxxx -v chat-ui-data:/data ghcr.io/huggingface/chat-ui-db:latest

关键配置

配置项	必填	说明	示例
`OPENAI_BASE_URL`	是	指定 OpenAI 兼容接口的基础地址	`https://router.huggingface.co/v1`
`OPENAI_API_KEY`	是	调用接口的密钥，随服务商不同而变化	`hf_xxxxxxxx`
`HF_TOKEN`	否	Hugging Face 密钥的旧别名，可替代 OPENAI_API_KEY	`hf_xxxxxxxx`

如何确认成功

浏览器自动打开本地地址并能正常发消息对话即为成功；Docker 方式访问 http://localhost:3000 验证。

常见问题

Q：chat-ui 支持哪些模型接口？

A：只支持 OpenAI 兼容 API，通过 OPENAI_BASE_URL 与 /models 端点工作。llama.cpp、Ollama、OpenRouter 等只要遵循 OpenAI 协议即可直接使用。

Q：怎么接本地 Ollama？

A：把 OPENAI_BASE_URL 设为 http://127.0.0.1:11434/v1，OPENAI_API_KEY 填 ollama 即可。

Q：怎么接 llama.cpp 服务？

A：OPENAI_BASE_URL 设为 http://127.0.0.1:8080/v1，OPENAI_API_KEY 可填任意字符串如 sk-local-demo，llama.cpp 会忽略它。

Q：老版本的 MODELS 环境变量还能用吗？

A：不能，MODELS、GGUF 发现、嵌入与联网搜索等厂商专属集成已被移除；需要旧功能请使用 legacy 分支。

Q：Docker 运行要另外装数据库吗？

A：不需要，chat-ui-db 镜像已在容器内捆绑 MongoDB，用 -v chat-ui-data:/data 挂载即可。

注意事项

除 OPENAI_BASE_URL 和 OPENAI_API_KEY 外，根目录 .env 模板列出了全部可选变量。
所有 .env.local 中可用的环境变量，在 Docker 方式下都能通过 -e 传入。
旧版本功能保留在 legacy 分支，新版本仅面向 OpenAI 兼容接口。

核心亮点

直接复用 HuggingChat 生产级代码，界面成熟稳定
支持流式输出、Markdown、代码高亮，交互体验完整
配置简单，通过环境变量即可切换模型和 API

不足之处

主要面向 Hugging Face 生态，对接其他服务需额外适配
文档/社区待观察

适用场景

快速搭建面向用户的 LLM 聊天演示或 MVP
为开源模型提供官方对话界面
作为企业内网私有化部署的聊天前端

替代项目

Open WebUI、Lobe Chat、NextChat

项目介绍

chat-ui 是对话助手领域的开源项目，由 huggingface 开发，2023 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（10,957）位列前 5%，在对话助手分类的 907 个项目里位列前 3%。

近 41 天，它的 GitHub 星标从 10,884 增加到 10,957，净增 73。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。HuggingChat 提供免费在线聊天服务，部分高级功能或模型可能需要付费或订阅，具体以官网为准。从国内网络环境看，可用性暂无实测数据。

它主要面向的使用场景是：快速搭建面向用户的LLM聊天演示或MVP。同类可对比的替代方案包括 Open WebUI、Lobe Chat、NextChat。

上一篇：aurora

下一篇：chatGPTBox