diff --git a/README.md b/README.md
index a577545dc8bc0fdd2d2a0bcdbec5f1e727df15b5..e6ff297e317986b63e5e385b10170b3eb8f9c182 100644
--- a/README.md
+++ b/README.md
@@ -1,17 +1,173 @@
-# **NeurIPS 2021 - The NetHack Challenge** - Getting started
-* **Challenge page** - https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge
-* **IMPORTANT - [Accept the rules before you submit](https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge/challenge_rules)**
-* **Join the discord server** - https://discord.gg/zkFWQmSWBA
-* Clone the starter kit to start competing - TODO Add final starter kit link
+# **NeurIPS 2021 - The NetHack Challenge** - Starter Kit
-This repository is the Nethack Challenge **Submission template and Starter kit**! It contains:
-* **Documentation** on how to submit your models to the leaderboard
-* **The procedure** for best practices and information on how we evaluate your agent, etc.
-* **Baselines** for you to get started with training easily
-<p style="text-align:center"><img style="text-align:center" src="https://raw.githubusercontent.com/facebookresearch/nle/master/dat/nle/example_run.gif"></p>
+This repository is the Nethack Challenge **Starter kit**! It contains:
+* **Instructions** for setting up your codebase to make submissions easy.
+* **Baselines** for quickly getting started training your agent.
+* **Notebooks** for introducing you to NetHack and the NLE
+* **Documentation** for how to submit your model to the leaderboard.
+
+Quick Links:
+
+* [the NetHack Challenge - Competition Page](https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge)
+* [the NetHack Challenge - Discord Server](https://discord.gg/zkFWQmSWBA)
+* [the NetHack Challenge - Starter Kit](https://gitlab.aicrowd.com/nethack/neurips-2021-the-nethack-challenge)
+* [IMPORTANT - Accept the rules before you submit](https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge/challenge_rules)
+
+
+# Table of Contents
+1. [Intro to Nethack and the Nethack Challenge](#intro-to-nethack-and-the-nethack-challenge)
+2. [Setting up your codebase](setting-up-your-codebase)
+3. [Baselines](baselines)
+4. [How to test and debug locally](how-to-test-and-debug-locally)
+5. [How to submit](how-to-ssubmit)
+
+# Intro to Nethack and the Nethack Challenge
+
+Your goal is to produce the best possible agent for navigating the depths
+of Nethack dungeons and emerging with the Amulet in hand!
+You can approach this task however you please, but a good starting point
+would be [this notebook](./notebooks/NetHackTutorial.ipynb) which provides
+an overview of (1) the many dynamics at play in the game and (2) the
+observation and action space with which your agent will interact.
+
+#### A high level description of the Challenge Procedure:
+1. **Sign up** to join the competition [on the AIcrowd website](https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge).
+2. **Clone** this repo and start developing your solution.
+3. **Train** your models on NLE, and ensure run.sh will generate rollouts.
+4. **Submit** your trained models to [AIcrowd Gitlab](https://gitlab.aicrowd.com)
+for evaluation (full instructions below). The automated evaluation setup
+will evaluate the submissions against the NLE environment for a fixed
+number of rollouts to compute and report the metrics on the leaderboard
+of the competition.
+
+
+
+# Setting Up Your Codebase
+
+AIcrowd provides great flexibility in the details of your submission!
+Find the answers to FAQs about submissions structure below, followed by
+the guide for setting up this starter kit and linking it to the AIcrowd
+GitLab.
+
+## FAQs
+
+**How does submission work?**
+
+The submission entrypoint is a bash script `run.sh`. When this script is
+called, aicrowd will expect you to generate all your rollouts in the
+allotted time, using `aicrowd_gym` in place of regular `gym`. This means
+that AIcrowd can make sure everyone is running the same environment,
+and can keep score!
+
+**What languages can I use?**
+
+Since the entrypoint is a bash script `run.sh`, you can call any arbitrary
+code from this script. However, to get you started, the environment is
+set up to generate rollouts in Python.
+
+The repo gives you a template placeholder to load your model
+(`agents/your_agent.py`), and a config to chose which agent to load
+(`submission_config.py`). You can then test a submission, adding all
+AIcrowd’s timeouts on the environment, with `python test_submission.py`
+
+**How do I specify my dependencies?**
+
+We accept submissions with custom runtimes, so you can choose your
+favorite! The configuration files typically include `requirements.txt`
+(pypi packages), `apt.txt` (apt packages) or even your own `Dockerfile`.
+
+You can check detailed information about the same in the `RUNTIME.md` file.
+
+**How can I get going with an existing baseline?**
+
+The best current baseline is torchbeast baseline. Follow the instructions
+[here](/nethack_baselines/torchbeast/) to install and start training
+the model (there are even some suggestions for improvements).
+
+To then submit your saved model, simply replace set he `AGENT` in
+`submission config` to be `TorchBeastAgent`, and modify the
+`agent/torchbeast_agent.py` to point to your saved directory.
+
+You can now test your saved model with `python test_baseline.py`
+
+**How can I get going with a completely new model?**
+
+Train your model as you like, and when you’re ready to submit, just adapt
+`YourAgent` in `agents/your_agent.py` to load your model and take a
+`batched_step`.
+
+Then just set your `AGENT` in `submission_config.py` to be this class
+and you are ready to test with `python test_submission.py`
+
+**How do I actually make a submission?**
+
+The submission is made by adding everything including the model to git,
+tagging the submission with a git tag that start `submission-`, and
+pushing to AIcrowd's GitLab. The rest is done for you!
+
+More details are available [here](/docs/SUBMISSION.md)
+
+**Are there any hardware or time constraints?**
+
+Your submission will need to complete 128 rollouts in 30 minutes. We will
+run 4 of these in parallel, a total of 512 episodes will be used for
+evaluation. The episode will timeout and terminate if any action is
+left hanging for 300 seconds, or 10,000 steps are taken without
+advancing the in game clock.
+
+The machine where the submission will run will have following specifications
+* 1 NVIDIA T4 GPU
+* 4 vCPUs
+* 16 GB RAM
+
+## Setting Up Details
+
+1. **Add your SSH key** to AIcrowd GitLab
+
+You can add your SSH Keys to your GitLab account by going to your profile settings [here](https://gitlab.aicrowd.com/profile/keys). If you do not have SSH Keys, you will first need to [generate one](https://docs.gitlab.com/ee/ssh/README.html#generating-a-new-ssh-key-pair).
+
+2. **Clone the repository** - TODO
+
+ ```
+ git clone git@gitlab.aicrowd.com:nethack/neurips-2021-the-nethack-challenge.git
+ ```
+
+3. **Install** competition specific dependencies!
+ ```
+ pip install -r requirements
+ ```
+
+4. Run rollouts with a random agent with `python test_submission.py`.
+
+# Baselines
+
+Although we are looking to supply this repository with more baselines throughout the first month of the competition, this repository comes with a strong IMPALA-based baseline in the directory `./nethack_baselines/torchbeast`.
+
+More info on how to install, train and submit that repo are available [here](./nethack_baselines/torchbeast/README.md) - along with some suggestions on where to go next!
+
+# How to Test and Debug Locally
+
+The best way to test your model is to run your submission locally.
+
+You can do this naively by simply running `python rollout.py` or you can simulate the extra timeout wrappers that AIcrowd will implement by using `python test_submission.py`.
+
+# How to Submit
+
+More information on submissions can be found at our [SUBMISSION.md](/docs/SUBMISSION.md)
+
+## Contributors
+
+- [Jyotish Poonganam](https://www.aicrowd.com/participants/jyotish)
+- [Dipam chakraborty](https://www.aicrowd.com/participants/dipam)
+- [Shivam Khandelwal](https://www.aicrowd.com/participants/shivam)
+- [Eric Hambro](https://www.aicrowd.com/participants/eric_hammy)
+
+
+<!--
+=================
# Table of Contents
@@ -67,7 +223,7 @@ environment for this:
```bash
$ conda create -n nle python=3.8
$ conda activate nle
-$ pip install git+https://github.com/facebookresearch/nle.git@eric/competition
+$ pip install git+https://github.com/facebookresearch/nle.git@eric/competition --no-binary:nle
```
Find more details on the [original nethack repository](https://github.com/facebookresearch/nle)
@@ -94,9 +250,8 @@ You can add your SSH Keys to your GitLab account by going to your profile settin
## Install NLE according to the instructions above
```
-4. Try out a random agent by setting `AGENT = RandomAgent` in `submission_config.py` and then running `rollout.py`.
+4. Try out random rollout script in `rollout.py`.
-5. See [this](/nethack_baselines/torchbeast/README.md) for an example of how to train and submit an IMPALA agent. Check out `nethack_baselines` for more examples.
## How do I specify my software runtime / dependencies ? - TODO
@@ -181,4 +336,50 @@ To be added
🆠Leaderboard: https://www.aicrowd.com/challenges/neurips-2021-nethack-challenge/leaderboards
-**Best of Luck** 🎉 🎉
\ No newline at end of file
+**Best of Luck** 🎉 🎉
+
+
+
+├── Dockerfile
+├── LICENSE
+├── README.md
+├── __pycache__
+│  ├── rollout.cpython-37.pyc
+│  └── submission_config.cpython-37.pyc
+├── agents
+│  ├── __pycache__
+│  ├── batched_agent.py
+│  ├── random_batched_agent.py
+│  ├── rllib_batched_agent.py
+│  └── torchbeast_agent.py
+├── aicrowd.json
+├── apt.txt
+├── docs
+│  ├── RUNTIME.md
+│  └── SUBMISSION.md
+├── envs
+│  ├── __init__.py
+│  ├── __pycache__
+│  ├── batched_env.py
+│  └── wrappers.py
+├── evaluation_utils
+│  └── custom_wrappers.py
+├── nethack_baselines
+│  ├── other_examples
+│  ├── rllib
+│  └── torchbeast
+├── notebooks
+├── requirements.txt
+├── rollout.py
+├── run.sh
+├── submission_config.py
+├── test_submission.py
+└── utility
+ ├── docker_build.sh
+ ├── docker_run.sh
+ ├── environ.sh
+ ├── parser.py
+ └── verify_or_download_data.py
+
+
+<p style="text-align:center"><img style="text-align:center" src="https://raw.githubusercontent.com/facebookresearch/nle/master/dat/nle/example_run.gif"></p> -->
\ No newline at end of file
diff --git a/requirements.txt b/requirements.txt
index b2ae9eb5646877f039602922835d4a1531affe1d..6b900b96fba403e1bb32fad52a02c77fd795ae8e 100644
--- a/requirements.txt
+++ b/requirements.txt
@@ -6,6 +6,6 @@ aicrowd-api
aicrowd-gym
numpy
scipy
-git+https://github.com/facebookresearch/nle.git@eric/competition --no-binary=nle
+nle
tqdm
wandb