Metadata-Version: 2.1
Name: iglu
Version: 0.2.2
Summary: IGLU: Interactive Grounded Language Understanding in Minecraft
Home-page: https://github.com/iglu-contest/iglu
Author: IGLU team
Author-email: info@iglu-contest.net
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: gym (>=0.18.3)
Requires-Dist: opencv-python (>=4.1.0.25)
Requires-Dist: setuptools (>=49.2.0)
Requires-Dist: tqdm (>=4.32.2)
Requires-Dist: numpy (>=1.16.2)
Requires-Dist: requests (>=2.20.0)
Requires-Dist: ipython (>=7.5.0)
Requires-Dist: typing (>=3.6.6)
Requires-Dist: lxml (>=4.3.3)
Requires-Dist: psutil (>=5.6.2)
Requires-Dist: Pyro4 (>=4.76)
Requires-Dist: coloredlogs (>=10.0)
Requires-Dist: pillow (>=8.0.0)
Requires-Dist: matplotlib (>=3.2.2)
Requires-Dist: dill (>=0.3.1.1)
Requires-Dist: daemoniker (>=0.2.3)
Requires-Dist: xmltodict (==0.12.0)
Requires-Dist: inflection (>=0.3.1)
Requires-Dist: jinja2 (>=2.11.2)
Requires-Dist: simple-term-menu
Requires-Dist: bullet
Requires-Dist: minerl-patched (==0.1.0)
Requires-Dist: pandas (==1.1.3)
Requires-Dist: getch (>=1.0) ; sys_platform != "win32" and sys_platform != "cygwin"

# Iglu Environment

The main documentation is available [here](https://iglu-contest.github.io/).

## Installation

### 1. JDK 1.8 installation 

#### On Ubuntu/Debian:

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

#### On Mac:

```bash
brew tap AdoptOpenJDK/openjdk
brew cask install adoptopenjdk8
```

#### On Windows:

Please use [Windows installer](https://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html).

### 3. Install xvfb

By default `iglu` renders using virtual display using `xvfb` software renderer. 

#### Debian and Ubuntu
```bash
sudo apt-get install xvfb
```

### 4. IgluEnv installation 

`iglu` env requires python version `3.7` or newer. If you are using `conda` you can easily install that in local conda env:

```bash
conda create -n iglu_env python=3.7
conda activate iglu_env
```

You can install using pip: `TODO`

To install the package manually, do the following:

```
git clone git@github.com:iglu-contest/iglu_env.git && cd iglu_env
python setup.py install
```

#### And then test your installation
```
cd test && python test_env.py
```
### Suggested requirements for RL solution

```bash
conda env update --file conda_env.yml
```

### Docker installation 

To use `iglu` environment inside the docker container proceed to [Docker installation](docker/getting_started.md) section.

