项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 21036
使用教程
环境要求
- Node.js 环境(README 使用 pnpm 管理依赖)
- pnpm 包管理器
- Vercel 账号并安装 Vercel CLI(用于拉取环境变量)
- 已按 .env.example 配置好环境变量
- 本地数据库(README 使用 Neon Serverless Postgres,需可连通)
安装与启动步骤
-
1安装 Vercel CLI
全局安装 Vercel 命令行工具,后续用于关联项目并拉取线上环境变量。
npm i -g vercel -
2关联 Vercel 项目
在项目根目录执行,按提示登录并关联 Vercel 与 GitHub 账号,生成 .vercel 目录。
vercel link -
3拉取环境变量
从 Vercel 下载环境变量,生成 .env 文件供本地运行使用。
vercel env pull -
4安装依赖
在项目根目录使用 pnpm 安装全部 JS/TS 依赖。
pnpm install -
5初始化数据库
执行数据库迁移,创建表结构或应用最新变更,需先保证数据库连接可用。
pnpm db:migrate -
6启动开发服务
运行开发服务器,默认监听 3000 端口,浏览器访问即可试用聊天界面。
pnpm dev
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
.env | 是 | 本地运行所需环境变量文件,内容依据 .env.example 填写 | .env(由 vercel env pull 生成) |
AI 模型提供商 API Key | 是 | 用于调用 OpenAI、Anthropic、Google、xAI 等模型服务 | sk-xxxxxxxx |
数据库连接串 | 是 | Neon Serverless Postgres 连接地址,用于保存会话与用户数据 | postgres://user:password@host/db |
认证提供方凭据 | 否 | 如 GitHub 登录所需的客户端 ID 与密钥 | GitHub OAuth 配置 |
如何确认成功
终端显示开发服务器已启动,浏览器打开 http://localhost:3000 能看到聊天页面并可发送消息。
常见问题
Q:必须使用 Vercel CLI 拉取环境变量吗?
A:README 推荐用 Vercel 环境变量,但也说明自建 .env 文件即可,只要内容参照 .env.example 填好即可本地运行。
Q:pnpm db:migrate 报错连不上数据库怎么办?
A:检查 .env 中数据库连接串是否正确、数据库实例是否可访问,确认后再重新执行迁移命令。
Q:可以不用 Vercel 部署吗?
A:README 提供一键部署到 Vercel 的方式,同时也支持本地运行,自托管需自行保证数据库与存储等服务可用。
Q:.env 文件可以提交到 Git 吗?
A:不可以。README 明确提示提交 .env 会泄露密钥,导致他人可操作你的 AI 与认证账号。
注意事项
- 不要把 .env 提交到仓库,避免泄露 AI 与认证账号密钥
- 本地运行依赖 .env.example 中定义的环境变量,缺失会导致启动或功能异常
- 数据库迁移必须先于启动开发服务器执行
- 默认访问地址为 http://localhost:3000
核心亮点
- 由 Vercel 官方维护,代码质量高,与 Next.js 生态深度集成
- 支持多种 AI 模型(OpenAI、Anthropic 等),切换灵活
- 内置认证、数据库、流式响应等生产级功能,开箱即用
不足之处
- 主要针对 Vercel 平台优化,部署到其他平台可能需额外配置
- 功能较多,对于简单聊天场景可能显得复杂
适用场景
- 快速构建 AI 聊天产品原型或 MVP
- 作为学习 Next.js + AI 应用开发的参考项目
- 需要多模型支持的企业级聊天应用基础
替代项目
LangChain Chat、Open WebUI、Lobe Chat
下一篇:NextChat
同类项目推荐
Stream-Omni
开源
一个模型搞定语音+视觉+文本,实时对话像 GPT-4o
Stream-Omni is a GPT-4o-like language-vision-speech chatbot that simultaneously supp···
ctxport
开源
一键把 AI 对话复制成干净 Markdown,侧边栏秒操作,本地零上传。
Copy AI conversations as clean Markdown Context Bundles — one click from ChatGPT, C···
Jarvis-Termux
开源
在 Termux 里用语音和文字指挥你的 AI 助手
jarvis ai for Termux;)
Pake
开源
一条命令把网页变成轻量桌面应用,告别 Electron 臃肿
Turn any website into a lightweight desktop app with one command, on macOS, Windows ···
openclaw-assistant
开源
离线唤醒,语音操控安卓,隐私无忧
OpenClaw voice assistant app for Android - Wake word activation & system assistant i···
HuixiangDou
开源
把技术问答机器人拉进群,自动翻文档答问题,省去人工重复答疑。
HuixiangDou: Overcoming Group Chat Scenarios with LLM-based Technical Assistance
gptspeaker
开源
用树莓派打造能语音聊天的 AI 助手,像 Siri 一样对话
The ChatGPT/DeepSeek Voice Assistant uses a Raspberry Pi (or desktop) to enable spok···
Chinese-Chatbot-PyTorch-Implemen···
开源
用PyTorch快速搭建中文聊天机器人,支持自定义语料训练。
:four_leaf_clover: Another Chinese chatbot implemented in PyTorch, which is the sub···
linebot
开源
用 Node.js 快速开发 LINE 聊天机器人
SDK for the LINE Messaging API for Node.js
