字节笔记本

2026年2月23日

Open R1 Chat Template:DeepSeek R1 聊天机器人模板

本文介绍 open-r1-chat-template,一个专为 DeepSeek R1 模型设计的开源 AI 聊天机器人模板。该项目提供了完整的推理过程展示功能和现代化的用户界面,帮助开发者快速构建基于 DeepSeek R1 的智能对话应用。

项目简介

open-r1-chat-template 是由 zaidmukaddam 开发的开源项目,基于 Next.js 14 构建,集成了 DeepSeek R1 大语言模型。截至目前,该项目在 GitHub 上已获得 53 stars 和 8 个 fork,主要使用 TypeScript (96.6%) 编写。

该模板的核心特点是能够展示 DeepSeek R1 模型的推理过程,让用户不仅看到最终回答,还能了解模型是如何一步步思考问题的。

核心特性

  • 🧠 DeepSeek R1 集成:原生支持 DeepSeek R1 大语言模型,提供强大的推理能力
  • 💭 推理过程可视化:独特的 UI 设计,清晰展示模型的推理链条和思考过程
  • 🎨 现代化界面:基于 Tailwind CSS 和 shadcn/ui 构建的简洁美观的用户界面
  • ⚡ 快速部署:一键部署到 Vercel,无需复杂配置
  • 🔧 易于定制:模块化代码结构,方便二次开发和功能扩展

技术栈

技术用途
Next.js 14React 框架,使用 App Router
TypeScript类型安全的 JavaScript 超集
Tailwind CSS原子化 CSS 框架
shadcn/ui现代化 UI 组件库
GroqAI 模型推理服务提供商
Bun高性能 JavaScript 运行时和包管理器

安装指南

前置要求

  • Node.js >= 18
  • Bun 包管理器(推荐)

安装步骤

  1. 克隆仓库
bash
git clone https://github.com/zaidmukaddam/open-r1-chat-template.git
cd open-r1-chat-template
  1. 安装依赖
bash
bun install
  1. 配置环境变量
bash
cp .env.example .env.local
  1. 添加 Groq API 密钥

编辑 .env.local 文件,添加你的 Groq API 密钥:

bash
GROQ_API_KEY=your-api-key-here

获取 API 密钥:Groq Console

快速开始

本地开发

bash
bun dev

启动后访问 http://localhost:3000 即可使用。

部署到生产环境

该项目支持一键部署到 Vercel:

Deploy with Vercel

点击上方按钮,按照 Vercel 的引导完成部署,只需在环境变量中填入 Groq API 密钥即可。

使用示例

部署完成后,你可以在聊天界面中:

  1. 输入问题或提示词
  2. 观察 DeepSeek R1 的推理过程展示
  3. 查看模型如何逐步分析问题并给出答案

例如,当你问一个数学问题时,界面会展示:

  • 模型理解问题的步骤
  • 推理过程中的中间计算
  • 最终答案的得出逻辑

项目结构

text
open-r1-chat-template/
├── app/              # Next.js App Router 页面
├── components/       # React 组件
├── hooks/            # 自定义 React Hooks
├── lib/              # 工具函数和配置
├── styles/           # 全局样式
├── .env.example      # 环境变量示例
└── package.json      # 项目依赖

注意事项

  • 需要有效的 Groq API 密钥才能正常使用
  • 建议使用 Bun 作为包管理器以获得最佳性能
  • 部署前确保环境变量已正确配置

项目链接

分享: