Welcome! This is a package intended for research into virtual intelligence in Minecraft.
By virtual intelligence, we mean "artificial intelligence that exists within a virtual world."
Minecraft offers a diverse, creative, and challenging virtual environment. While it is far from a perfect simulator for the real world (it's a video game...), we believe that it is a close enough approximation that methods that work here may have the potential to work in the real world.
If you would like to contribute to the project, you can start by forking the repository and adding things there. Then submit a PR and we will review your work to see if it fits with what we are trying to accomplish. If you have ideas you think may benefit the project, feel free to submit an Issue.
We are still early in the planning and development phase of the project. The first goal is to develop visual perception and curiosity while restricting the agent to only move through the environment.
First, clone the repository:
git clone https://github.com/thomashopkins32/Minecraft-Virtual-Intelligence.git
cd Minecraft-Virtual-IntelligenceRECOMMENDED: We recommend using Pixi to install the project by simply running:
pixi installIf you want to a conda environment you can install like so:
conda create -n mvi python=3.11
conda activate mvi
pip install .
# Install custom MineDojo fork
git clone https://github.com/thomashopkins32/MineDojo.git
cd MineDojo
pip install .
cd ..The official MineDojo distribution as of writing this is no longer maintained and package versions aren't frozen which can lead to compatability errors. Because of this, we recommend installing the forked version of MineDojo.
To run the project, you can use the mvi command.
Either using Pixi:
pixi run mviOr if you installed with conda or venv:
mviThis will start the project and you can use the mvi command to run the project starting from the engine.run function.
To view a list of all the commands you can use, run mvi --help.