REK-proj-2/README.md

# Recommender Systems class - Project 2

## Preparing your system

1. Install [Docker](https://docs.docker.com/engine/install/).

2. Fork this repository to your GitHub account.

3. Pull Jupyter image:

```bash
docker pull jupyter/minimal-notebook:latest
```

4. Run Jupyter docker image:

```bash
docker run \
	-d -p 8888:8888 \
	-v DIRECTORY:/home/jovyan/REK \
	--name REK \
	jupyter/minimal-notebook
```

Remember to change **DIRECTORY** to directory where all files can be found. You can change it to `$(pwd)` if your current directory is proper one. 

5. Get loging link with following command:

```bash
docker logs REK 2>&1 | grep -o 'http://127.0.0.1:8888/?token.*' | tail -n1

Example output:
http://127.0.0.1:8888/?token=2bb816a4bc36a4bdbf64e0c9a89f336ae5404a01d15e442c
```

If above command did not work. Just find it in logs:
```bash
docker logs REK
```

6. Prepare conda environment:

```bash
docker exec REK bash -c "
conda env create --name REK -f /home/jovyan/REK/environment.yml;
conda run -n REK /bin/bash -c \"
python -m ipykernel install --user --name=REK\""
```

7. You can start/stop container whenever you want:

```bash
docker stop REK
docker start REK
```

If you want to start from scratch, you can remove container:

```bash
docker stop REK
docker rm REK
```

Now you are ready to work!