虚拟家庭模拟器（VirtualHome）安装与配置指南

虚拟家庭模拟器（VirtualHome）安装与配置指南

virtualhome API to run VirtualHome, a Multi-Agent Household Simulator 项目地址: https://gitcode.com/gh_mirrors/vi/virtualhome

1. 项目基础介绍

VirtualHome 是一个开源的交互式平台，用于模拟复杂的家庭活动。该平台允许与环境进行复杂的交互，例如拿起物体、开关电器、打开电器等。用户可以通过 Python API 轻松调用模拟器，编写活动作为简单的指令序列，然后在 VirtualHome 中渲染。该项目支持选择不同的代理和环境，并且可以实时修改环境。

主要编程语言：Python

2. 关键技术和框架

• Unity 引擎：用于生成活动视频的模拟器。
• 图谱表示：定义活动发生的环境。
• 强化学习环境：提供与 Ray 结合的接口，用于并行运行多个环境，扩展强化学习算法。

3. 安装和配置

准备工作

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

• Python 3.6 或更高版本 -pip（Python 包管理器）
• Jupyter（可选，用于运行演示笔记本）

安装步骤

步骤 1：安装 VirtualHome 包

打开命令行窗口，执行以下命令安装 VirtualHome：

pip install virtualhome

步骤 2：安装 Jupyter（可选）

如果需要运行演示笔记本，请安装 Jupyter：

pip install jupyter

步骤 3：下载 Unity Simulator

根据您的操作系统，从以下链接下载相应的 Unity Simulator 执行文件，并将其移动到 simulation/unity_simulator 目录下：

• Linux x86-64 版本
• Mac OS X 版本
• Windows 版本

步骤 4：测试 Unity Simulator

• 对于本地机器，双击执行文件或在终端中运行。如果通过终端运行，建议设置窗口模式：

  ./path_to_exec -screen-fullscreen 0 -screen-quality 4
  

• 如果没有显示器或希望远程测试模拟器，可以使用 Docker 或 X 服务器。使用 X 服务器时，运行以下命令：

  sudo python helper_scripts/startx.py $display_num
  

  在另一个终端中，运行：

  DISPLAY=:display_num ./path_sim/exec_file.x86_64 -batchmode
  

步骤 5：运行演示

如果已经安装了 Jupyter，可以在命令行中运行以下命令来启动 Jupyter：

jupyter notebook

然后打开 demo/unity_demo.ipynb 笔记本文件，按照说明运行演示。

注意事项

• 确保在安装和运行过程中，所有路径和文件名都是正确的。
• 如果遇到任何问题，可以查看项目的 GitHub 页面或相关文档以获取帮助。

以上就是 VirtualHome 的详细安装和配置指南，按照以上步骤，即使是编程小白也能顺利安装并运行该项目。

virtualhome API to run VirtualHome, a Multi-Agent Household Simulator 项目地址: https://gitcode.com/gh_mirrors/vi/virtualhome