目录

• 为什么选择Adeus？
• Adeus的构建方式
• 文档
  • 入门指南
  • 如何贡献代码

为什么选择Adeus？

在即将到来的世界中，个人AI将成为我们日常生活不可或缺的一部分，它们将始终陪伴左右，并且对我们的了解将如同最亲密的朋友一般深入。因此，借助Adeus，我们确保其完全开源，让你能够完全拥有自己的数据。

Adeus的构建方式

Adeus由三个部分组成：

1. 移动/网页应用： 提供一个界面，让用户可以通过聊天与他们的个人AI及数据进行交互。

2. 硬件设备： 这款可穿戴设备会记录用户所说或所听到的一切内容，并将其发送至后端进行处理。

3. Supabase： 后端与数据库，用于处理和存储数据，以及与大型语言模型进行交互。

文档：

• 入门指南
• 如何贡献代码？

由社区共同打造，满怀热爱：

ADeus 快速上手指南

ADeus 是一款开源的 AI 可穿戴设备项目，旨在捕捉用户的语音和听觉信息，转录并存储在您自建的服务器上，从而构建一个完全属于您个人的、具备上下文感知能力的个性化 AI。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Linux (推荐 Ubuntu 20.04+), macOS, 或 Windows (需配合 WSL2)。
• Node.js：版本 18.x 或更高（用于运行前端应用）。
• Python：版本 3.9+（用于后端处理脚本，如有需要）。
• Git：用于克隆代码仓库。
• Supabase 账户：项目依赖 Supabase 作为后端数据库和 API 服务，您需要一个免费的 Supabase 项目。
• 硬件设备（可选）：如果您计划自行组装硬件，需要准备 ESP32-S3 开发板、麦克风模块等（具体清单请参考官方文档硬件部分）。本指南主要侧重软件环境搭建。

国内开发者提示：

• 克隆仓库时若速度慢，可使用 Gitee 镜像（如有）或配置 Git 代理。
• Node.js 依赖安装缓慢时，建议切换至淘宝镜像源：

  npm config set registry https://registry.npmmirror.com
  

安装步骤

1. 克隆项目代码

git clone https://github.com/adamcohenhillel/ADeus.git
cd ADues

2. 配置 Supabase 后端

1. 登录 Supabase 创建一个新项目。
2. 进入项目设置，获取 URL 和 anon/public key。
3. 在项目根目录下创建 .env 文件，填入以下配置：

cp .env.example .env

编辑 .env 文件：

SUPABASE_URL=your_supabase_project_url
SUPABASE_ANON_KEY=your_supabase_anon_key
# 其他配置项参考 .env.example 补充

4. 按照 Supabase 快速入门文档 运行 SQL 迁移脚本，初始化数据库表结构。

3. 安装前端依赖并启动

进入前端目录（通常为 app 或根目录，视具体结构调整）：

npm install
npm run dev

启动后，终端通常会显示本地访问地址（如 http://localhost:3000）。

4. 硬件固件烧录（可选）

如果您已准备好硬件设备，请使用 PlatformIO 或 Arduino IDE 打开 firmware 目录，配置 Wi-Fi 凭证和后端 API 地址，然后编译并烧录到 ESP32 设备中。

基本使用

完成上述步骤后，您即可体验 ADeus 的核心功能：

1. 访问应用：在浏览器中打开 http://localhost:3000。
2. 连接设备：确保您的可穿戴设备已开机并连接到网络，它会自动将录音数据发送至您配置的 Supabase 后端。
3. 开始对话：
   • 在网页聊天界面输入问题，例如：“我今天上午听到了什么关于项目的讨论？”
   • ADeus 将检索数据库中存储的转录文本，结合上下文为您提供回答。

简单示例代码（测试数据插入）：

如果您暂时无法使用硬件，可以通过 Supabase Dashboard 手动插入一条测试记录来验证聊天功能：

-- 在 Supabase SQL Editor 中运行
INSERT INTO recordings (content, created_at)
VALUES ('这是一个测试录音，内容是关于明天会议的安排。', NOW());

随后在聊天窗口询问“明天的会议安排”，系统应能基于该条记录进行回复。

---

注：详细硬件组装指南及贡献流程请参阅 官方文档。