billsplit 的安装和配置教程

项目基础介绍

billsplit 是一个现代化的账单分摊应用程序，它允许用户轻松地分割餐厅账单。该项目采用了现代化的技术栈，旨在为用户提供一个流畅且高效的用户体验。

主要编程语言

该项目主要使用 TypeScript 进行开发，辅以 CSS 和少量的 JavaScript。

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

• Next.js 15: 用于现代网页开发的框架，这里使用了 App Router。
• Together.ai: 提供高级语言模型能力，用于处理 PDF 文件。
• Helicone: 用于语言模型的可见性和监控。
• Amazon S3: 用于安全的图像存储。
• Vercel: 用于无缝的部署和托管。

项目安装和配置的准备工作

在开始安装和配置之前，请确保您已经完成了以下准备工作：

• 安装了 Node.js 环境。
• 创建了一个 Together.ai 账户。
• 创建了一个 AWS 账户，并且准备好了一个 S3 存储桶。
• 准备好了 .env 文件（可以参考 .example.env）。

详细安装步骤

1. 克隆或分支项目

   首先，您需要克隆或分支项目到本地环境。在命令行中执行以下命令：

   git clone https://github.com/Nutlope/billsplit.git
   cd billsplit
   

2. 设置环境变量

   使用 .example.env 文件作为参考，创建一个 .env 文件，并替换 Together.ai 和 AWS 的 API 密钥。

   TOGETHER_AI_API_KEY=your_together_ai_api_key
   AWS_ACCESS_KEY_ID=your_aws_access_key_id
   AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key
   AWS_S3_BUCKET_NAME=your_s3_bucket_name
   

3. 安装依赖

   在项目目录中，运行以下命令来安装项目依赖：

   pnpm install
   

4. 运行项目

   依赖安装完成后，使用以下命令来启动开发服务器：

   pnpm run dev
   

   现在，您应该能够在浏览器中访问 http://localhost:3000 来查看运行中的应用程序。

以上步骤即为 billsplit 项目的安装和配置指南，按照这些步骤操作，即使是编程小白也能顺利完成安装。