Skip to content

ankitagarg26/HowToUseMineRL

Repository files navigation

HowToUseMineRL

MineRL is a research project started at Carnegie Mellon University aimed at developing various aspects of AI within minecraft.

To accesss MineRL dataset and Gym environments, you will need to install the main python package minerl.

Installation on Linux

Install JDK 1.8 on your system

  sudo add-apt-repository ppa:openjdk-r/ppa
  sudo apt-get update
  sudo apt-get install openjdk-8-jdk

Install the minerl package

pip3 install --upgrade minerl

Note: You may need the user flag: pip3 install --upgrade minerl --user to install properly.

Install xvfb

In order to run minerl environments without a head i.e. without any external display monitor you need to installa software renderer.

sudo apt install xvfb

Install Environment

You can use the environment.yml file to install the conda environment on your system, which will install all of the Python libraries required for the sample codes in this repository.

Run the below command to copy the environment.

conda env create -f environment.yml

Before running above command make sure conda is installed on the system. If not, you can follow the instructions here to install conda.

Run sample code

Run the sample code to test the installation.

xvfb-run python3 random_agent.py

Start with MineRL

To create your first agent, you can follow the instructions here

Use MineRL on the server

On the server, go to path /mnt/ShareFolder/MineRL and activate the environment using below command:

 conda activate minerl

You can now use the minerl package in your code.

MineRL sample code and datasets can be found in the directories listed below:

  1. Sample codes: /mnt/ShareFolder/MineRL/HowToUseMineRL
  2. MineRL dataset: /mnt/ShareFolder/MineRL/data

Official Doc and Reference

MineRL official documentation:

https://minerl.readthedocs.io/en/latest/

https://github.com/minerllabs/minerl

https://minerl.io/workshop/

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published