zero-calendar 的安装和配置教程

2025-05-21 00:40:56作者：霍妲思

1. 项目基础介绍和主要编程语言

zero-calendar 是一个开源的人工智能日历解决方案，它可以帮助用户智能地管理日程，并支持与外部服务如 Google Calendar 等日历服务进行集成。该项目的目标是利用人工智能助手和大型语言模型（LLMs）来提升日程安排的效率和体验。zero-calendar 旨在为用户提供一个现代、高效且注重隐私的日程管理工具。

该项目主要使用 TypeScript 作为编程语言，同时也使用了 CSS 和其他一些技术。

2. 项目使用的关键技术和框架

zero-calendar 在开发过程中使用了一系列现代和可靠的技术和框架，主要包括：

前端框架： Next.js、React、TypeScript、TailwindCSS、Shadcn UI
后端框架： Next.js API Routes、Server Actions
数据库： Vercel KV (Redis)
认证： NextAuth.js、Google OAuth
人工智能： AI SDK、Groq

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

在开始安装 zero-calendar 之前，请确保您的系统中已安装以下版本的工具：

Node.js (v18 或更高版本)
npm (v9 或更高版本) 或 pnpm (v8 或更高版本)

安装步骤

克隆项目仓库： 在命令行中执行以下命令，克隆项目仓库到本地：
```
git clone https://github.com/Zero-Calendar/zero-calendar.git
cd zero-calendar
```
安装依赖： 使用 npm 或 pnpm 安装项目依赖：
```
npm install
```
或者
```
pnpm install
```
配置环境变量： 将 .env.example 文件复制为 .env.local 并在项目根目录中配置以下环境变量：
```
cp .env.example .env.local
```
配置以下环境变量：
- NEXTAUTH_SECRET：认证所需的密钥（使用 openssl rand -hex 32 生成）
- NEXTAUTH_URL：应用的 URL（本地开发时为 http://localhost:3000）
- GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET：Google Calendar 集成所需的客户端 ID 和密钥
- KV_URL、KV_REST_API_URL、KV_REST_API_TOKEN 和 KV_REST_API_READ_ONLY_TOKEN：Vercel KV (Redis) 的相关配置
- GROQ_API_KEY：AI 功能所需的 API 密钥
启动应用： 使用以下命令启动应用：
```
npm run dev
```
或者
```
pnpm dev
```
访问应用： 在浏览器中访问 http://localhost:3000，即可查看和操作 zero-calendar 应用。