GitHub_Trending/pe/personal-ai快速开始：3分钟搭建你的智能聊天助手

GitHub_Trending/pe/personal-ai快速开始：3分钟搭建你的智能聊天助手

【免费下载链接】personal-ai 项目地址: https://gitcode.com/GitHub_Trending/pe/personal-ai

你还在为复杂的AI助手部署流程烦恼吗？还在担心没有专用硬件无法使用智能助手吗？本文将带你3分钟上手GitHub_Trending/pe/personal-ai项目，无需专用硬件，通过平台服务和Apple Shortcuts，轻松搭建属于你的智能聊天助手，实现天气查询等实用功能。读完本文，你将掌握项目的克隆、依赖安装、配置部署以及Shortcuts设置的全流程，让AI助手即刻为你服务。

项目简介

GitHub_Trending/pe/personal-ai是一个基于平台服务的个人AI助手项目，它可以与Apple Shortcuts配合使用，无需专用硬件设备。该助手能够与任何LLM（大型语言模型）协同工作，本项目代码示例中使用Llama 3模型，并支持自定义函数调用，例如获取天气数据等功能。通过简单的配置和部署，你就能拥有一个功能强大的智能聊天助手。

项目结构概览

项目的核心文件和目录结构如下，了解这些结构有助于你更好地理解项目的工作原理和后续操作：

• 配置文件：wrangler.toml 用于平台服务的配置，包括项目名称、入口文件以及KV命名空间等信息；package.json 包含项目的依赖项和脚本命令，如测试、开发和部署等。
• 源代码目录：src/ 是项目的核心代码目录，其中src/index.ts 是项目的入口文件；src/chat.ts 处理聊天相关的逻辑；src/history.ts 负责聊天历史的管理；src/functions/ 目录下包含函数定义，如type.ts 定义类型，weather.ts 实现天气查询功能，index.ts 是函数的入口。
• 许可和说明文件：LICENSE 是项目的许可文件；README.md 提供了项目的详细说明和使用指南。

快速上手步骤

1. 克隆项目仓库

首先，你需要将项目克隆到本地。打开终端，执行以下命令：

git clone https://gitcode.com/GitHub_Trending/pe/personal-ai
cd GitHub_Trending/pe/personal-ai

通过上述命令，你将把项目代码下载到本地，并进入项目的根目录，为后续的操作做好准备。

2. 安装项目依赖

进入项目根目录后，需要安装项目所需的依赖。在终端中运行以下命令：

npm install

这一步会根据package.json 文件中的依赖配置，自动下载并安装项目运行所必需的库和工具，如hono、openai等。

3. 平台账户认证

由于项目基于平台服务运行，因此需要进行平台账户的认证。在终端执行：

npx wrangler login

运行该命令后，会打开浏览器引导你登录平台账户，完成认证后，终端会显示认证成功的信息，这样你就可以使用平台的相关服务了。

4. 创建 KV 命名空间

KV命名空间用于在平台服务中存储数据，本项目需要创建两个KV命名空间，一个用于生产环境，一个用于预览环境。在终端分别执行以下两条命令：

npx wrangler kv:namespace create chats
npx wrangler kv:namespace create chats --preview

执行每条命令后，终端会返回一个ID，请注意记录这两个ID，它们将在后续的配置中使用。

5. 配置项目

5.1 更新 wrangler.toml 文件

打开wrangler.toml 文件，找到kv_namespaces部分，将之前记录的两个ID分别填入id和preview_id字段，如下所示：

kv_namespaces = [
  { binding = "personal_ai_chats", id = "你的生产环境ID", preview_id = "你的预览环境ID"}
]

这样，平台服务就能正确关联到创建的KV命名空间，用于存储聊天数据。

5.2 设置 API 密钥

项目需要GROQ API密钥和OpenWeatherMap API密钥来实现LLM模型调用和天气查询功能。

• 获取GROQ API密钥：访问GroqCloud 网站，注册并登录账户，在账户设置中获取API密钥。
• 获取OpenWeatherMap API密钥：访问OpenWeather 网站，注册账户后，在个人中心获取API密钥。

获取密钥后，在终端分别执行以下命令设置密钥：

npx wrangler secret put GROQ_API_KEY
npx wrangler secret put OPENWEATHERMAP_API_KEY

执行命令后，终端会提示你输入对应的API密钥，输入完成后按回车确认，密钥将安全地存储在平台中。

6. 部署平台 Worker

完成上述配置后，就可以将项目部署到平台 Worker 了。在终端执行以下命令：

npx wrangler deploy

部署成功后，终端会显示部署的URL，例如https://personal-ai.<your-username>.workers.dev，请记录下这个URL，它是你的AI助手的访问地址。

7. 设置 Apple Shortcuts

7.1 安装 Shortcut

使用Apple设备，通过以下步骤安装Shortcut：在Safari浏览器中打开相关的Shortcut链接（可参考README.md 中的指引），点击“获取捷径”，将其添加到你的Shortcuts应用中。

7.2 配置 Shortcut

打开Shortcuts应用，找到刚刚安装的个人AI助手捷径，点击右上角的编辑按钮。在编辑界面中，找到“URL”字段，将其替换为你在部署步骤中获得的平台 Worker URL，保存修改。

功能演示与使用

完成以上所有步骤后，你的智能聊天助手就已经搭建完成了。打开Apple Shortcuts应用，运行配置好的个人AI助手捷径，你就可以开始与AI助手进行对话了。你可以向它询问天气情况，例如“今天北京的天气怎么样？”，助手会通过调用天气查询函数，为你返回准确的天气信息。

总结与展望

通过本文的步骤，你已经成功搭建了基于GitHub_Trending/pe/personal-ai项目的智能聊天助手。该项目利用平台服务的强大能力，实现了无需专用硬件的AI助手部署，结合Apple Shortcuts，让你随时随地都能使用AI服务。

未来，你可以根据自己的需求，扩展项目的功能，例如添加更多自定义函数，实现诸如日程安排、新闻查询等功能。同时，你也可以探索不同的LLM模型，优化AI助手的响应效果。希望这个智能聊天助手能为你的生活和工作带来便利，快去体验吧！

如果你在使用过程中遇到任何问题，可以查阅项目的README.md 或相关源代码文件，获取更详细的信息和帮助。

【免费下载链接】personal-ai 项目地址: https://gitcode.com/GitHub_Trending/pe/personal-ai