AI Baby Monitor项目启动与配置教程

1. 项目目录结构及介绍

AI Baby Monitor项目的目录结构如下：

ai-baby-monitor/
├── assets/             # 存放GIF演示等资源
├── configs/            # 配置文件目录，包含不同房间的规则配置
├── scripts/            # 脚本目录，包含启动监控等脚本
├── src/                # 源代码目录，包含监控逻辑等
├── tests/              # 测试代码目录
├── .dockerignore       # Docker忽略文件
├── .env.template       # 环境变量模板文件
├── .gitignore          # Git忽略文件
├── .python-version     # Python版本文件
├── Dockerfile.python   # Dockerfile文件，用于构建Python环境
├── LICENSE             # 项目许可证文件
├── README.md           # 项目说明文件
├── docker-compose.yml  # Docker Compose文件，用于定义和启动服务
├── pyproject.toml      # Python项目配置文件
└── uv.lock             # uv工具的锁文件

2. 项目的启动文件介绍

项目的启动主要通过以下文件进行：

• docker-compose.yml：定义了项目中需要启动的Docker服务，包括Redis、vLLM模型服务、视频流服务和Streamlit仪表板服务。
• scripts/run_watcher.py：Python脚本，用于启动监控服务，读取配置文件中的规则，并将视频流数据发送到vLLM服务进行推理。

启动项目时，首先需要构建并启动Docker服务：

docker compose up --build -d

然后，在宿主机上启动监控服务：

uv run scripts/run_watcher.py --config-file configs/living_room.yaml

这里living_room.yaml是配置文件，定义了监控的房间和规则。

3. 项目的配置文件介绍

项目的配置文件位于configs/目录下，以YAML格式编写。以下是配置文件的基本结构：

name: "living_room"
camera:
  uri: "0"  # 这里可以是webcam的索引或者RTSP URI
instructions:
  - "The baby shouldn't do anything dangerous."
  - "An adult should be in the room if the baby is awake."

配置文件中定义了房间名称（name）、摄像头URI（camera）以及监控规则（instructions）。监控规则使用自然语言描述，项目中的AI模型将根据这些规则进行判断，并在检测到异常情况时发出警报。

每个房间都需要一个相应的配置文件，如果项目需要监控多个房间，可以在docker-compose.yml中添加相应的服务配置，并在宿主机上为每个房间启动一个run_watcher.py进程。

请确保在.env文件中正确设置了所有环境变量，包括LLM模型名称等，以确保项目可以正确运行。