SvelteKit AI Chatbot 项目介绍
项目概述
SvelteKit AI Chatbot 是一个开源的人工智能聊天机器人应用模板。它使用了 SvelteKit、Vercel AI SDK、OpenAI 和 Vercel KV 开发。这个项目是 vercel-labs/ai-chatbot 的一个非官方版本,旨在帮助开发者快速搭建自己的 AI 聊天机器人应用。
项目特点
- 使用 SvelteKit:这是一个强大的现代前端框架,让开发变得更加轻松。
- Vercel AI SDK:提供流畅的聊天用户界面。
- 多种 AI 模型的支持:默认支持 OpenAI,同时允许切换到其他如 Anthropic、HuggingFace 或使用 LangChain 的自定义 AI 聊天模型。
- 边缘运行时准备:确保应用在边缘计算平台上高效运行。
- 丰富的 UI 组件:集成了 shadcn/ui、Tailwind CSS、Radix Svelte 和 Svelte Headless UI,提供优美且可自定义的用户界面。
- 数据持久化与限流:通过 Vercel KV 实现聊天历史记录、限流和会话存储。
- 用户认证:使用 Auth.js 提供用户认证功能。
模型供应商
虽然该模板默认使用 OpenAI 的 gpt-3.5-turbo
,但得益于 Vercel AI SDK 的灵活性,开发者可以轻松切换到其他长语言模型 (LLM) 提供商如 Anthropic、HuggingFace,或使用 LangChain,只需修改几行代码。
部署你的版本
用户可以通过简单的一键部署将自己的 AI 聊天机器人版本托管到 Vercel。需要设置的环境变量包括 OPENAI_API_KEY
、AUTH_SECRET
、GITHUB_ID
和 GITHUB_SECRET
。详情可以在项目文档中找到。
创建一个 KV 数据库实例
Vercel 提供了详细的快速入门指南,帮助用户创建和配置 KV 数据库实例。这一步骤将使应用程序能够与存储在 Vercel 上的数据库进行交互。
用户需在 .env
文件中更新环境变量 (KV_URL
, KV_REST_API_URL
, KV_REST_API_TOKEN
, KV_REST_API_READ_ONLY_TOKEN
),以便正确配置 KV 数据库的连接。
本地运行
为了在本地运行 SvelteKit AI Chatbot,用户需要:
- 安装必要的环境变量,推荐使用 Vercel 提供的环境变量管理工具。
- 安装 Vercel CLI:
npm i -g vercel
- 将本地实例与 Vercel 和 GitHub 账户关联:
vercel link
- 下载环境变量:
vercel env pull
然后,运行以下命令启动开发服务器:
npm install
npm run dev
或者,使用以下命令在新浏览器标签中打开应用程序:
npm run dev -- --open
这样,应用就会在 localhost:5173 上运行。
项目作者
这个 SvelteKit 模板主要基于 Next.js 版本的AI Chatbot 创作,感谢 Jian Yuan Lee 以及其他贡献者的努力。