chat-demo

开箱即用的聊天界面模板,快速搭出对话 Demo

开源 🏷️完全免费 ⏳ 访问状态待核验 对话助手 🍴 复刻 272 🐛 待处理 1 👀 关注 6
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1665
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源演示项目,免费使用

项目预览

chat-demo 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类对话助手
开发团队deepseek-ai
定价模式🏷️完全免费
价格说明开源演示项目,免费使用
访问状态⏳ 访问状态待核验
是否开源是
开源协议MIT
主要语言TypeScript
GitHub 星标★ 1665
上线时间2026-11-12 00:00:00
代码更新2026-11-13
仓库体积123 KB
本站数据更新2026-11-15
维护状态活跃
收录时间2026-11-15
浏览次数0

项目介绍

chat-demo 是一个用 TypeScript 编写的开源对话助手示例项目,主要面向想快速搭建聊天界面的开发者。它提供了一套可运行的对话交互前端与基础逻辑,涵盖消息列表渲染、输入发送、流式回复展示等常见能力,帮助开发者跳过从零搭建 UI 和交互流程的阶段,直接在此基础上接入自己的模型服务或后端接口。项目结构清晰、技术栈现代,适合作为学习对话类产品前端架构的参考模板,也可作为内部原型或 Demo 的起点。对于需要定制化聊天体验的团队,它可以减少重复造轮子的成本,把精力集中在业务逻辑与模型能力上。

Star 增长趋势

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

数据来源:GitHub API 逐日快照 · 收录于 2026-11-15 · 当前星标 ★ 1665

使用教程

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

环境要求

  • Node.js 22.12 或更高版本
  • pnpm 包管理器
  • 现代浏览器(需要支持在 file:// 页面使用存储)
  • 可用的 DeepSeek API Key
  • 如需直接打开构建结果,API 服务需允许跨域请求

安装与启动步骤

  1. 1准备运行环境

    先安装 Node.js 22.12+,再安装 pnpm。README 未给出具体安装命令,请按各自官方文档完成安装并确认版本满足要求。

  2. 2克隆项目代码

    把仓库克隆到本地并进入项目目录,后续命令都在该目录下执行。

    git clone https://github.com/deepseek-ai/chat-demo.git
    cd chat-demo
  3. 3安装项目依赖

    在项目根目录执行依赖安装,等待 pnpm 完成下载;如网络较慢可先配置好可用的镜像源。

    pnpm install
  4. 4启动开发服务

    启动本地开发服务器,随后在浏览器访问 http://localhost:8090 打开聊天界面。

    pnpm dev
  5. 5填写 API Key

    首次对话前,在页面设置中填入自己的 API Key,并确认 API 服务地址为你要使用的服务。

  6. 6构建静态站点

    需要部署时执行构建,产物输出到 dist/ 目录,可放到静态 Web 服务器,或直接打开 dist/index.html。

    pnpm build

关键配置

配置项必填说明示例
API Key是在页面设置中填入,用于浏览器直连 API 服务发起对话sk-xxxxxxxx

如何确认成功

浏览器打开 http://localhost:8090 能看到聊天界面,设置中填入 API Key 后发送消息可获得回复。

常见问题

Q:这个项目需要自己搭后端吗?

A:不需要。它是纯静态应用,浏览器直接连接所配置的 API 服务,只需提供 API Key 即可。

Q:可以直接双击 index.html 使用吗?

A:可以,但要求浏览器支持在 file:// 页面使用存储,且所连 API 服务允许该来源的跨域请求,否则请用静态服务器部署 dist/。

Q:访问 localhost:8090 打不开怎么办?

A:确认 pnpm dev 仍在运行且没有报错;若端口被占用,可先释放 8090 端口,或改用 pnpm build 的产物部署到静态服务器。

Q:没有 pnpm 能用 npm 吗?

A:README 只给出 pnpm 的使用方式,建议先安装 Node.js 22.12+ 再安装 pnpm,按文档命令执行以避免依赖解析差异。

注意事项

  • API Key 只保存在浏览器本地设置中,不要写进代码仓库或公开分享。
  • 直接打开 dist/index.html 受浏览器存储与跨域策略限制,正式使用建议部署到静态 Web 服务器。
  • 项目为纯前端静态实现,模型能力完全依赖你所配置的 API 服务。

核心亮点

  • TypeScript 编写,类型完整,便于二次开发和维护
  • 提供完整可运行的对话交互流程,省去从零搭 UI 的成本
  • 结构清晰,适合作为学习对话产品前端架构的参考模板

不足之处

  • 功能偏示例性质,缺少生产级能力如鉴权、多会话管理等
  • 文档与社区规模有限,长期维护情况待观察

适用场景

  • 快速搭建聊天机器人前端原型
  • 学习对话类产品的前端交互与流式渲染实现
  • 作为内部 Demo 或 PoC 的起点进行定制开发

替代项目

chatbot-ui、NextChat、lobe-chat

上一篇:SnowCatQQ

下一篇:没有了!

同类项目推荐

ChatPLUG 开源

中文开放域对话,知识增强更懂你

A Chinese Open-Domain Dialogue System

★ 323 2026-08-09
tiny-robot 开源

拿来即用的 AI 对话界面组件,快速搭出企业级聊天应用

TinyRobot 是一个 AI 对话组件库,提供了丰富的 AI 交互组件,助力开发者快速构建企业级 A···

★ 104 2026-10-27
DAMO-ConvAI 开源

达摩院对话AI代码库,直接复现工业级对话模型

DAMO-ConvAI: The official repository which contains the codebase for Alibaba DAMO Co···

★ 1624 2026-09-25
gpt_mobile 开源

一个 App 同时问遍所有大模型,自带 Key 即用

Chat app for Android that supports answers from multiple LLMs at once. Bring your ow···

★ 1270 2026-08-09
slack-machine 开源

用 Python 快速搭建可扩展的 Slack 机器人

A simple, yet powerful and extendable Slack bot

★ 770 2026-08-09
UnilmChatchitRobot 开源

用 UniLM 打造会夸人的中文闲聊机器人

Unilm for Chinese Chitchat Robot.基于Unilm模型的夸夸式闲聊机器人项目。

★ 157 2026-08-09
xiaogpt 开源

让小米音箱秒变 ChatGPT 语音入口,动口就能聊

Play ChatGPT and other LLM with Xiaomi AI Speaker

★ 7040 2026-08-09
ChatterBot 开源

几行代码训练你的聊天机器人,快速上手对话系统

ChatterBot is a machine learning, conversational dialog engine for creating chat bot···

★ 14523 2026-08-09
WeatherBot 开源

用中文聊天气,Rasa 机器人秒回,带网页界面

一个基于 Rasa 的中文天气情况问询机器人(chatbot), 带 Web UI 界面

★ 239 2026-08-09