README.md

Docker images for NLE

This directory -- i.e., docker/ -- contains some docker images that we use for testing both locally and in CI. They contain dependencies and a pre-built version of NLE.

You can try out the latest stable version by doing:

$ docker pull fairnle/nle:stable
$ docker run --rm -it fairnle/nle:stable python  # or bash
# Then you can simply use the nle package as normal

The git repository is installed inside a conda distribution, and can be found in /opt/nle inside the images.

The DockerHub repository also contains pre-built images per each released version of nle, following a specific templates:

1. fairnle/nle:stable
2. fairnle/nle:<nle-version>         # corresponds to (1)
3. fairnle/nle-xenial:<nle-version>  # Based on Ubuntu 16.04
4. fairnle/nle:<sha>                 # xenial image built on dockerfile changes
5. fairnle/nle-xenial:<sha>          # bionic image built on dockerfile changes
6. fairnle/nle:dev                   # points to latest built sha
7. fairnle/nle-xenial:dev            # points to latest built sha

<nle-version> is the latest pip version released, and follows semantic versioning (so something like X.Y.Z).

Building images locally

To build any of them (e.g. the main Dockerfile) do:

$ git clone https://github.com/facebookresearch/nle --recursive
$ cd nle
$ docker build -f docker/Dockerfile . -t nle:latest