home-generative-agent 的安装和配置教程

项目基础介绍

home-generative-agent 是一个基于 Home Assistant 的开源项目，旨在创建一个能够与智能家庭环境互动并自动执行任务的生成式 AI 代理。该代理能够理解家庭上下文，学习用户偏好，并与用户和家庭设备互动，完成用户认为有价值的活动。该项目的主要编程语言是 Python。

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

该项目使用了以下关键技术和框架：

• LangChain: 一个用于构建生成式 AI 应用的框架。
• LangGraph: LangChain 的扩展，用于创建和管理复杂的生成式 AI 代理运行时。
• Home Assistant: 一个流行的开源智能家居平台，用于控制家庭自动化设备。
• LLM (Large Language Models): 大型语言模型，用于高级推理和规划。

项目安装和配置准备工作

在开始安装之前，请确保您的系统满足以下要求：

• Python 3.8 或更高版本
• Home Assistant 2025.5.0 或更高版本
• Home Assistant 的 conversation 组件
• Home Assistant Core 和 Home Assistant Community Store (HACS)

确保您的 Home Assistant 系统已经安装并运行正常，同时您的计算机上已安装 Python 和必要的依赖项。

详细安装步骤

步骤 1：安装 Python 依赖

首先，您需要安装项目所需的 Python 依赖项。在您的终端中，运行以下命令：

pip install -r requirements.txt

步骤 2：克隆项目仓库

接下来，使用 Git 克隆项目仓库到您的计算机：

git clone https://github.com/goruck/home-generative-agent.git

步骤 3：配置 Home Assistant

1. 打开 Home Assistant 的配置文件（通常位于 ~/.homeassistant/configuration.yaml）。
2. 在配置文件中添加以下内容：

home_generative_agent:
  # 在这里添加您的配置信息

3. 保存并关闭配置文件。

步骤 4：安装 Home Assistant 蓝图

1. 在 Home Assistant 的 UI 中，导航到 “配置” -> “蓝图”。
2. 点击 “添加蓝图”，然后选择 home-generative-agent 项目的蓝图文件，通常是 blueprints/hga_scene_analysis.yaml。
3. 安装蓝图并等待 Home Assistant 重新加载。

步骤 5：配置代理

1. 在 Home Assistant 的 UI 中，导航到 “配置” -> “集成”。
2. 查找并点击 home-generative-agent 集成。
3. 在集成页面中，填写所需的配置信息，如允许的实体、通知设置等。
4. 保存配置并等待 Home Assistant 应用更改。

步骤 6：测试代理

1. 在 Home Assistant 的对话组件中与代理进行交互，例如通过语音或聊天界面。
2. 观察代理是否能够正确响应并执行任务。

完成以上步骤后，您的 home-generative-agent 应该已经成功安装并配置好了。现在您可以开始使用它来自动化您的智能家居任务了。