gemini-chatbot

用 Vercel AI SDK + Gemini 快速搭建生成式 UI 聊天机器人

gemini-chatbot 是一个基于 Vercel AI SDK 和 Google Gemini 模型构建生成式 UI 聊天机器人的开源模板。它解决了开发者从零搭建 AI 聊天界面和交互逻辑的繁琐问题，提供了一套完整的、可快速上手的解决方案。核心能力包括：集成 Gemini Pro 模型，支持流式响应，提供可复用的聊天 UI 组件，并实现了生成式 UI（即模型输出可触发前端组件渲染）的交互模式。项目采用 TypeScript 编写，基于 Next.js 和 React，部署在 Vercel 上，适合作为学习或生产级聊天应用的起点。

开源 unknown 对话助手

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1353

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类对话助手

开发团队vercel-labs

所属国家

官网地址https://gemini.vercel.ai

GitHubhttps://github.com/vercel-labs/gemini-chatbot

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议NOASSERTION

主要语言TypeScript

技术栈/模型ai,chatbot,gemini-pro,nextjs,react,typescript,vercel

GitHub 星标★ 1353

30天Star增速

HF 下载量

上线时间2024-04-03 00:00:00

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

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数4

使用教程

难度：进阶约 15 分钟部署方式：本地安装 5 步

环境要求

Node.js 环境与 pnpm 包管理器
Vercel 账号及 Vercel CLI
README 中 .env.example 所列的环境变量（模型与认证服务密钥）
可访问 Google Gemini 等模型服务的 API 凭据

安装与启动步骤

1安装 Vercel CLI

全局安装 Vercel 命令行工具，后续用它关联项目并拉取环境变量。
```
npm i -g vercel
```
2关联 Vercel 项目

在项目目录执行，按提示登录并绑定 Vercel 与 GitHub 账号，生成 .vercel 目录。
```
vercel link
```
3拉取环境变量

把 Vercel 项目里配置的环境变量下载到本地 .env 文件，供应用读取。
```
vercel env pull
```
4安装依赖

在项目根目录用 pnpm 安装全部依赖，需联网下载 npm 包。
```
pnpm install
```
5启动开发服务

运行开发服务器，启动完成后应用默认监听 3000 端口。
```
pnpm dev
```

如何确认成功

终端显示启动成功后，浏览器打开 http://localhost:3000/ 能看到聊天界面并正常对话。

常见问题

Q：可以不用 Vercel CLI 吗？

A：可以。README 说明用 Vercel CLI 只是推荐方式，手动把 .env.example 复制为 .env 并填写变量同样能本地运行。

Q：环境变量该填哪些值？

A：参考项目根目录的 .env.example，其中列出了运行所需的全部变量名，按注释填入自己的密钥即可。

Q：本地访问地址是什么？

A：README 明确说明应用运行在 http://localhost:3000/，即默认 3000 端口。

Q：可以把 .env 提交到 Git 吗？

A：不能。README 特别提醒提交 .env 会泄露密钥，导致他人可控制你的 Google Cloud 和认证服务账号。

注意事项

务必不要将 .env 文件提交到代码仓库。
本地运行前建议确认 pnpm 已安装，README 使用 pnpm 作为包管理器。
部署到 Vercel 可用官方一键部署按钮，README 未给出具体命令。

核心亮点

完整集成 Vercel AI SDK 与 Gemini Pro，开箱即用的流式聊天体验
展示生成式 UI 交互模式，模型输出可动态渲染 React 组件
基于 Next.js 和 TypeScript，代码结构清晰，易于定制扩展

不足之处

依赖 Vercel 和 Google Cloud 服务，本地开发需配置密钥
文档/社区待观察

适用场景

快速构建 AI 聊天机器人 MVP 或产品原型
学习 Vercel AI SDK 与生成式 UI 的实践案例
作为企业内部客服或知识问答助手的基础框架

替代项目

chatbot-ui、assistant-ui、shadcn/ui chat

项目介绍

gemini-chatbot 是对话助手领域的开源项目，由 vercel-labs 开发，2024 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（1,353）位列前 30%，在对话助手分类中处于中上游。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。从国内网络环境看，可直接访问。

它主要面向的使用场景是：快速构建AI聊天机器人MVP或产品原型。同类可对比的替代方案包括 chatbot-ui、assistant-ui、shadcn/ui chat。

上一篇：Discord-AI-Chatbot

下一篇：bedrock-chat