chat-ui

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

开源 🏷️基础免费，高级付费 ⏳ 访问状态待核验对话助手 🍴 复刻 1716 🐛 待处理 326 👀 关注 97

GitHub ↗

GitHub 星标 ★ 11025

维护状态活跃

是否开源开源

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

项目预览

项目数据

分类对话助手

开发团队huggingface

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

定价模式🏷️基础免费，高级付费

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

访问状态⏳ 访问状态待核验

是否开源是

开源协议Apache-2.0

主要语言TypeScript

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

GitHub 星标★ 11025

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

代码更新2026-11-06

仓库体积17.7 MB

本站数据更新2026-11-08

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11025

技术标签

chatgpt hacktoberfest huggingface llm svelte

使用教程

难度：入门约 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`