MineStudio安装与配置指南

1. 项目基础介绍

MineStudio 是一个旨在帮助开发者快速开发 Minecraft AI 代理的工具包。它提供了一系列工具和 API，包括模拟器、数据结构、模型模板、离线训练、在线训练、推理框架以及自动化基准测试等功能。

主要编程语言：Python、Java

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

• 模拟器：基于 MineRL 的可定制 Minecraft 模拟器。
• 数据结构：用于高效存储和检索任意轨迹段落的轨迹数据结构。
• 模型：Minecraft 策略模型的模板和一系列基线模型。
• 训练：支持离线数据预训练和在线强化学习。
• 推理：基于 Ray 的并行和分布式推理框架。
• 基准测试：自动化和批量测试多种 Minecraft 任务。

3. 项目安装和配置的准备工作

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

• 操作系统：Linux 或 macOS
• Python：3.10 或更高版本
• Java：JDK 8
• 其他：可能需要安装 VirtualGL 或 Xvfb（对于非 NVIDIA 显卡用户）

详细安装步骤

1. 安装 Python 和 Java

   首先确保您的系统中安装了 Python 3.10 或更高版本以及 JDK 8。

2. 创建虚拟环境

   使用 conda 创建一个名为 minestudio 的虚拟环境，并激活它。

   conda create -n minestudio python=3.10 -y
   conda activate minestudio
   

3. 安装 Java

   通过 conda 安装 JDK 8。

   conda install --channel=conda-forge openjdk=8 -y
   

4. 安装 MineStudio

   MineStudio 可以通过 pip 从 PyPI 安装。

   pip install MineStudio
   

   或者，如果您想从源代码安装，可以使用以下命令：

   pip install git+https://github.com/CraftJarvis/MineStudio.git
   

5. 安装模拟器所需的渲染工具

   对于拥有 NVIDIA 显卡的用户，推荐安装 VirtualGL。对于其他用户，可以使用 Xvfb，但它相对较慢。

   • 对于 NVIDIA 用户：

     # 安装 VirtualGL
     

   • 对于非 NVIDIA 用户：

     # 安装 Xvfb
     

6. 验证安装

   运行以下命令来检查安装是否成功。

   python -m minestudio.simulator.entry
   

   如果使用 Xvfb，请使用以下命令：

   MINESTUDIO_GPU_RENDER=1 python -m minestudio.simulator.entry
   

以上步骤将帮助您成功安装和配置 MineStudio。如果您遇到任何问题，请参考项目的官方文档或向社区寻求帮助。