minerl  by minerllabs

Gym environments for training agents in Minecraft

created 6 years ago
825 stars

Top 44.1% on sourcepulse

GitHubView on GitHub
Project Summary

This Python package provides Gym environments and data access for training agents in Minecraft, targeting researchers and developers in sample-efficient reinforcement learning. It offers a standardized interface to Minecraft for RL experimentation, enabling the development and benchmarking of advanced AI agents.

How It Works

MineRL integrates with Minecraft, providing a Gym-like API to interact with the game. It leverages a custom Minecraft client to render observations (pixels) and execute actions, abstracting away complex game mechanics. The package supports multiple versions, each tailored for specific competition datasets and Minecraft versions, offering flexibility for different research needs.

Quick Start & Requirements

  • Install with pip install git+https://github.com/minerllabs/minerl.
  • Requires Java JDK 8 (additional steps may be needed for macOS).
  • Official documentation: https://minerl.io/docs/

Highlighted Details

  • Supports multiple MineRL versions (v1.0, v0.4, v0.3) with distinct features and datasets.
  • v1.0 features a new Minecraft version (11.2-16.5), higher resolution (640x360), and a near-human action space focusing on GUI and mouse control.
  • Original MineRL-v0 datasets are available via Zenodo: https://zenodo.org/records/12659939.
  • Example usage provided for basic environment interaction and agent control.

Maintenance & Community

Licensing & Compatibility

  • The license is not explicitly stated in the README. Compatibility for commercial use or closed-source linking is not specified.

Limitations & Caveats

The README mentions that original data mirrors for MineRL-v0 are down, with copies provided on Zenodo. Specific compatibility notes for macOS installation are also mentioned.

Health Check
Last commit

6 months ago

Responsiveness

Inactive

Pull Requests (30d)
0
Issues (30d)
0
Star History
46 stars in the last 90 days

Explore Similar Projects

Starred by Thomas Wolf Thomas Wolf(Cofounder of Hugging Face), Chip Huyen Chip Huyen(Author of AI Engineering, Designing Machine Learning Systems), and
2 more.

Gymnasium by Farama-Foundation

0.7%
10k
Python API standard for single-agent reinforcement learning environments
created 2 years ago
updated 2 days ago
Feedback? Help us improve.