Installation
Welcome to MineRL! This guide will get you started.
To start using the MineRL dataset and Gym environments comprising MineRL, you’ll need to install the
main python package, minerl
.
First make sure you have JDK 8 installed on your system.
Windows installer – On windows go this link and follow the instructions to install JDK 8. Install x64 version.
On Mac, you can install Java 8 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). If you encounter errors installing MineRL, try these steps for Mac:
brew tap AdoptOpenJDK/openjdk brew install --cask 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 # Verify installation java -version # this should output "1.8.X_XXX" # If you are still seeing a wrong Java version, you may use # the following line to update it # sudo update-alternatives --config java
If you are using Windows, you will also need
bash
command. The best way to do is to install Windows Subsystem for Linux (WSL. Tested on WSL 2). Note that installing MineRL may seem especially slow/stuck, but it is not; it is just a bit slow. You can also install MineRL on the WSL system itself, but you may needxvfb
to run the environment. Note that you need to install correct Java version on the WSL, too!Now install the
minerl
package!:pip install git+https://github.com/minerllabs/minerl
Note
You may need the user flag:
pip install git+https://github.com/minerllabs/minerl --user
to install properly.