Installation
Welcome to MineRL! This guide will get you started.
To start using the data and set of reinforcement learning
environments comprising MineRL, you’ll need to install the
main python package, minerl
.
First make sure you have JDK 1.8 installed on your system.
Windows installer – On windows go this link and follow the instructions to install JDK 8.
On Mac, you can install java8 using homebrew and AdoptOpenJDK (an open source mirror, used here to get around the fact that Java8 binaries are no longer available directly from Oracle):
brew tap AdoptOpenJDK/openjdk brew cask install adoptopenjdk8
On Debian based systems (Ubuntu!) you can run the following:
sudo add-apt-repository ppa:openjdk-r/ppa sudo apt-get update sudo apt-get install openjdk-8-jdk
Now install the
minerl
package!:pip3 install --upgrade minerl
Note
depending on your system you may need the user flag:
pip3 install --upgrade minerl --user
to install property
(Optional) Download the dataset ~ 60 GB:
import minerl minerl.data.download(directory="/your/local/path/")
Or simply download a single experiment
minerl.data.download('/your/local/path',experiment='MineRLObtainDiamondVectorObf-v0')
For a complete list of published experiments, checkout the environment documentation. If you are here for the MineRL competition, checkout the competition environments.
That’s it! Now you’re good to go :) 💯💯💯
Caution
Currently minerl
only supports environment rendering in headed environments
(machines with monitors attached).
In order to run minerl
environments without a head use a software renderer
such as xvfb
:
xvfb-run python3 <your_script.py>