deep-chat

拖拽级接入，快速给网站加上可定制的 AI 聊天框

deep-chat 是一个高度可定制的 AI 聊天机器人前端组件，专为网站集成而设计。它解决了开发者需要快速嵌入对话功能但又不想从零构建的痛点，提供开箱即用的 UI 组件，同时支持深度定制。核心能力包括：支持多种主流 AI 后端（如 OpenAI、Claude、Gemini、DeepSeek、Ollama、Hugging Face 等），可无缝切换或对接自定义 API；提供丰富的 UI 配置项，可调整样式、布局、消息气泡、输入框等，甚至支持自定义渲染逻辑；内置流式响应、文件上传、语音输入等常见交互功能；基于 TypeScript 开发，类型安全，易于维护。它适用于 React 和 Next.js 项目，也可通过 Web Component 方式嵌入任意前端框架。整体上，它让开发者能快速构建专业级聊天界面，同时保留完全的控制权。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3722

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队OvidijusParsiunas

所属国家

官网地址https://deepchat.dev

GitHubhttps://github.com/OvidijusParsiunas/deep-chat

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai,ai-chatbot,chat,chatbot,chatgpt,claude,component,deepseek,gemini,huggingface,next,nextjs,ollama,openai,react,react-chatbot,realtime,solid,svelte,vue

GitHub 星标★ 3722

30天Star增速

HF 下载量

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

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

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：库/依赖 4 步

环境要求

已安装 Node.js 与 npm（需要执行 npm install）
若使用 React，需要已有的 React 项目
可正常访问 npm 源的网络环境

安装与启动步骤

1安装主包

在项目根目录执行安装命令，把 deep-chat 加入依赖。适用于非 React 的普通网页项目。
```
npm install deep-chat
```
2React 项目改装

如果项目使用 React，README 要求改装 deep-chat-react 这个包，而不是主包。
```
npm install deep-chat-react
```
3在页面中插入组件

在页面标记里加入一个 deep-chat 标签即可渲染聊天组件；不同框架的具体写法不同，需查阅官方示例。
4借助 AI 助手配置

可把 README 提供的 llms.txt 作为参考交给代码助手，让它帮你完成安装与配置。
```
Use https://github.com/OvidijusParsiunas/deep-chat/blob/main/llms.txt to add a chat component to my website.
```

如何确认成功

安装无报错，且页面中出现可交互的 deep-chat 聊天组件。

常见问题

Q：应该装 deep-chat 还是 deep-chat-react？

A：普通网页项目装 deep-chat；React 项目按 README 要求改装 deep-chat-react。

Q：不同框架的标签写法一样吗？

A：不一样。README 明确说明具体语法取决于所用框架，需参考官网框架示例页面。

Q：如何接入 OpenAI、Claude 等模型？

A：README 提到组件支持从浏览器直连 20 多个主流 AI API，具体配置需查阅官网文档。

Q：不想手写配置怎么办？

A：可按 README 建议，把仓库中的 llms.txt 链接交给 AI 代码助手，由它协助安装与配置。

注意事项

README 未给出端口、环境变量或密钥配置，本教程不涉及这些内容。
组件全部能力（文件上传、语音、Markdown 等）需查阅官网 deepchat.dev 文档。
接入第三方 AI API 的具体参数以官网 directConnection 文档为准。

核心亮点

支持 OpenAI、Claude、Gemini、Ollama 等几乎所有主流 AI 后端，切换成本低
UI 定制粒度细，从颜色、字体到消息气泡布局都能改，满足品牌需求
基于 TypeScript，类型提示完善，且提供 Web Component 版本，可嵌入非 React 项目

不足之处

文档偏重基础用法，高级定制示例不够丰富，需自行探索源码
项目仍处于成长阶段，社区生态和第三方插件相对较少

适用场景

企业官网快速集成智能客服机器人
SaaS 产品内嵌 AI 助手，需与品牌风格一致
开发者快速搭建 AI 应用原型，验证交互流程

替代项目

react-chatbotify、chatbot-ui、openchat

项目介绍

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

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,722）位列前 30%，在对话助手分类的 905 个项目里位列前 7%。

近 45 天，它的 GitHub 星标从 3,691 增加到 3,722，净增 31。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：企业官网快速集成智能客服机器人。同类可对比的替代方案包括 react-chatbotify、chatbot-ui、openchat。

上一篇：olivia

下一篇：qqbot