From a2f3c2dc74f08a0cd9039d7f70dac4b0eeebfd33 Mon Sep 17 00:00:00 2001 From: bjoernellens1 <64093272+bjoernellens1@users.noreply.github.com> Date: Fri, 26 Apr 2024 10:14:51 +0200 Subject: [PATCH] Update README.md Added Docker informations. Might need some improvements regarding GPUs. --- README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/README.md b/README.md index 420b1cb..2716f06 100644 --- a/README.md +++ b/README.md @@ -24,6 +24,21 @@ This repository contains the implementation for training and evaluating the MVit 4. **Evaluation**: Once the model is trained, use the `evaluate.ipynb` notebook to train a linear classifier on the top of the learned representations to evaluate its performance on test data. 5. **Utilities**: The `utils.py` script contains helper functions. It's integrated into the training and evaluation notebooks, so there's no need to run it separately. +## How to use - Docker + +As an alternative to the above steps, we used Docker to implement a straight-forward way to get this project running. The easiest way for a new user is the [Devcontainer Extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) in the [Visual Studio Code IDE](https://code.visualstudio.com/). Hence, when you open this repository in Visual Studio code, it will ask you to open the workspace inside a container. Click yes. + +Also you might want to build the Docker image yourself and run it manually. Follow these steps: + +1. [Install](https://docs.docker.com/get-docker/) Docker obviously +2. Clone this repository and cd into it +3. Build the image: `docker build .devcontainer -t mvitac` +4. Run the container: `docker run -it -p 8888:8888 -v ${PWD}:/home/mvitacdev/mvitacdev_ws mvitac bash` + +### Additional Notes - GPU +You might want to [use your GPU inside of the container](https://github.com/NVIDIA/nvidia-container-toolkit). +This part will be updated. + ## Notes - Ensure the data paths in the configuration are correctly set.