Skip to content

Commit

Permalink
Small doc fixes
Browse files Browse the repository at this point in the history
Signed-off-by: Fabrice Normandin <[email protected]>
  • Loading branch information
lebrice committed Jul 2, 2024
1 parent dacfe68 commit fe27e47
Show file tree
Hide file tree
Showing 2 changed files with 34 additions and 35 deletions.
65 changes: 32 additions & 33 deletions docs/getting_started/install.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,59 +15,58 @@ You need to have [Conda](https://docs.conda.io/en/latest/) installed on your mac

1. Clone the repository and navigate to the root directory:

```bash
git clone https://www.github.com/mila-iqia/ResearchTemplate
cd ResearchTemplate
```
```bash
git clone https://www.github.com/mila-iqia/ResearchTemplate
cd ResearchTemplate
```

1. Create a conda environment
2. Create a conda environment

```bash
conda create -n research_template python=3.12
conda activate research_template
```
```bash
conda create -n research_template python=3.12
conda activate research_template
```

```
Notes:
Notes:

- If you don't Conda installed, you can download it from [here](https://docs.conda.io/en/latest/miniconda.html).
- If you'd rather use a virtual environment instead of Conda, you can totally do so, as long as you have a version of Python >= 3.12.
<!-- TODO: - If you're on the `mila` cluster, you can run this setup script: (...) -->
```
- If you don't Conda installed, you can download it from [here](https://docs.conda.io/en/latest/miniconda.html).
- If you'd rather use a virtual environment instead of Conda, you can totally do so, as long as you have a version of Python >= 3.12.

1. Install the package using pip:
<!-- TODO: - If you're on the `mila` cluster, you can run this setup script: (...) -->
```bash
pip install -e .
```
3. Install the package using pip:
Optionally, you can also install the package using [PDM](https://pdm-project.org/en/latest/). This makes it easier to add or change the dependencies later on:
```bash
pip install -e .
```
```bash
pip install pdm
pdm install
```
Optionally, you can also install the package using [PDM](https://pdm-project.org/en/latest/). This makes it easier to add or change the dependencies later on:
```bash
pip install pdm
pdm install
```
## Using a development container
This repo provides a [Devcontainer](https://code.visualstudio.com/docs/remote/containers) configuration for [Visual Studio Code](https://code.visualstudio.com/) to use a Docker container as a pre-configured development environment. This avoids struggles setting up a development environment and makes them reproducible and consistent. and make yourself familiar with the [container tutorials](https://code.visualstudio.com/docs/remote/containers-tutorial) if you want to use them. In order to use GPUs, you can enable them within the `.devcontainer/devcontainer.json` file.
1. Setup Docker on your local machine
On an Linux machine where you have root access, you can install Docker using the following commands:
On an Linux machine where you have root access, you can install Docker using the following commands:
```bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```
```bash
curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh
```
On Windows or Mac, follow [these installation instructions](https://code.visualstudio.com/docs/remote/containers#_installation)
On Windows or Mac, follow [these installation instructions](https://code.visualstudio.com/docs/remote/containers#_installation)
1. (optional) Install the [nvidia-container-toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) to use your local machine's GPU(s).
2. (optional) Install the [nvidia-container-toolkit](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/latest/install-guide.html) to use your local machine's GPU(s).

2. Install the [Dev Containers extension](vscode:extension/ms-vscode-remote.remote-containers) for Visual Studio Code.
3. Install the [Dev Containers extension](vscode:extension/ms-vscode-remote.remote-containers) for Visual Studio Code.

3. When opening repository in Visual Studio Code, you should be prompted to reopen the repository in a container:
4. When opening repository in Visual Studio Code, you should be prompted to reopen the repository in a container:

![VsCode popup image](https://github.com/mila-iqia/ResearchTemplate/assets/13387299/37d00ce7-1214-44b2-b1d6-411ee286999f)

Expand Down
4 changes: 2 additions & 2 deletions docs/overview/intro.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,8 +24,8 @@ You are welcome (and encouraged) to use other similar templates which, at the ti
- A comprehensive suite of automated tests for new algorithms, datasets and networks
- Automatically creates Yaml Schemas for your Hydra config files (as soon as #7 is merged)

This template is geared specifically for ML researchers that run their jobs on SLURM clusters.
A particular emphasis for development specifically with a SLURM cluster, and more particularly still, with the Mila and DRAC clusters in mind. The target audience is (currently) limited to Mila researchers, but there's no reason why this
This template is aimed for ML researchers that run their jobs on SLURM clusters.
The target audience is researchers and students at [Mila](https://mila.quebec). This template should still be useful for others outside of Mila that use PyTorch-Lightning and Hydra.

## Main concepts

Expand Down

0 comments on commit fe27e47

Please sign in to comment.