Life-Agent-RU-YEE 快速上手：5 步部署你的 AI 生活管理 Agent（含 Docker 一键部署）

Life-Agent-RU-YEE 是一个 AI 驱动的生活管理 Agent 框架：通过自然语言对话，它就能自动规划菜谱、在盒马 APP 上把食材加进购物车，还能记住你的口味偏好。本文带你用5 个步骤完成部署，也提供Docker 一键部署方案，零基础也能快速跑起来。

部署前你需要了解什么

Life-Agent-RU-YEE 采用可插拔架构，核心能力由四类插件组成（见 plugins/ 目录）：

多个 Agent 之间的协作由编排引擎驱动，核心逻辑在 core/orchestrator.py。前端是 Vue 3 + TypeScript（web/src/），后端是 FastAPI（入口 main.py）。

环境准备：前置条件清单

💡 如果不想本地安装 Python 和 Node.js，直接跳到 Docker 一键部署 部分即可。

本地开发部署：5 步跑起来

第 1 步：克隆仓库

git clone https://gitcode.com/gh_mirrors/li/Life-Agent-RU-YEE cd Life-Agent-RU-YEE

第 2 步：配置环境变量

复制模板文件 ​.env.example，并填入至少一个 LLM API Key：

cp .env.example .env

📌 三个 Key 都不填也没关系——项目会自动回退到 Ollama 本地模型。

第 3 步：启动基础设施

用 Docker 拉起 PostgreSQL 和 Redis 两个容器，省去手动安装数据库的麻烦：

docker compose up -d postgres redis

第 4 步：安装并启动后端

python -m venv .venv source .venv/bin/activate # Windows 用户：.venv\Scripts\activate pip install -e ".[dev]" python main.py

启动成功后，后端服务运行在http://localhost:8000，浏览器访问http://localhost:8000/docs可以查看完整的 API 文档。

第 5 步：安装并启动前端

cd web npm install npm run dev

打开http://localhost:5173，API 请求会自动代理到后端。对着输入框说一句"今晚吃什么"，你就能完整体验从菜谱规划到一键加购的多 Agent 协作流程 ✅

Docker 一键部署：更省事的替代方案

如果你不需要改源码，一条命令就能把整个系统跑起来：

cp .env.example .env # 编辑 .env：填入 LLM API Key 和数据库密码 docker compose up --build -d

多阶段构建由 Dockerfile 完成（前端产物 → 后端镜像 → Nginx 网关），docker-compose.yml 会启动 4 个容器：

• app：FastAPI 后端（含插件加载、健康检查）
• postgres/redis：数据库与缓存（带持久化卷）
• nginx：静态前端 + 反向代理，对外端口由.env中的NGINX_PORT控制，默认 80

部署完成后访问http://localhost即可使用。

验证部署是否成功

# 查看容器状态 docker compose ps # 健康检查 curl http://localhost/api/health # 期望返回 {"status":"ok","service":"Life-Agent-RU-YEE",...}

健康检查端点定义在 api/health.py，Docker 也会用它来判断服务是否就绪。

开发模式：热更新 + USB 透传

在开发 Docker 化部署时，复制覆盖文件模板即可开启：

cp docker-compose.override.yml.example docker-compose.override.yml docker compose up --build -d

开发模式（docker-compose.override.yml.example）额外提供：源码 volume 挂载热更新、数据库/Redis 端口暴露（5433 / 6380）、USB 设备透传。

自定义 IP 白名单

Nginx 层通过 nginx-allow.conf 控制可访问的 IP 段，修改后重启网关即可生效，无需重建镜像：

docker compose restart nginx

核心配置文件速查

比如想让饮食规划 Agent 支持更多菜系，修改 config.yaml 中meal_agent的cuisine_styles即可。

可选进阶：接入安卓设备（采购 Agent）

采购 Agent 依赖 uiautomator2 控制安卓手机操作盒马 APP（plugins/extensions/automation_u2/），两种接入方式：

1. USB 连接：设备开启 USB 调试后连接服务器，Docker 开发模式已配置 USB 透传；
2. 网络连接：在 config.yaml 中配置automation_u2的device_addr（如192.168.1.100:5555）。

下一步做什么

• 🧪 跑一遍测试套件确认环境无误：python -m pytest tests/ -v（前端为npx vitest run）
• 📖 阅读架构设计与实现文档：docs/ 与 RFC-001 Markdown 技能层提案
• 🔌 想扩展能力？Agent、Memory、Extension 都是插件，参考 README.md 中的项目结构说明

至此，你的 AI 生活管理 Agent 已经部署完成——一句"今晚吃什么"，剩下的交给 Life-Agent-RU-YEE。