Developer Install

The following sections provide detailed guidance for developers that wish to contribute to navigate. They aim to help you set up your development environment, effectively work with the codebase, and contribute to its growth.

• Download and Install Git

• Create Directory for Installation

• Fork Repository

• Clone Repository

• Install navigate in a Virtual Environment

Download Git

If you do not have Git already installed, you will need to do so before cloning the repo. We also recommend installing GitHub Desktop for a more user-friendly experience.

Create a directory where the repository will be cloned

We recommend a path/location that is easy to find and access such as the your Desktop or Documents. Once the folder is created, we will want to change that to our working directory (e.g., cd).

• Windows

  (navigate) C:\Users\Username> cd Desktop
  (navigate) C:\Users\Username\Desktop> mkdir Code
  (navigate) C:\users\Username\Desktop> cd Code
  

• Linux/Mac

  (navigate) MyComputer ~ $ mkdir ~/Desktop/Code
  (navigate) MyComputer ~ $ cd ~/Desktop/Code
  

Working with a Fork

For external contributors, we recommend forking the repository first. If you do not intend to contribute to the project, you can skip this step and clone the main repository directly.

1. Visit https://github.com/TheDeanLab/navigate and click the “Fork” button

2. Clone your fork instead of the main repository:

git clone https://github.com/YOUR-USERNAME/navigate.git
cd navigate

3. Set up the upstream remote to keep your fork updated:

git remote add upstream https://github.com/TheDeanLab/navigate.git

4. Create a branch for your changes:

git checkout -b your-feature-branch

Clone the GitHub repository

For those who do not want to fork the repository, you can clone the main repository directly. This will create a local copy of the repository on your machine.

C:\Users\Username\Code> $ git clone https://github.com/TheDeanLab/navigate.git

Install navigate in a Virtual Environment

We strongly recommend using a virtual environment for development. This can be accomplished either with Python’s built-in venv or conda.

# Using venv
python -m venv navigate-env

# On Windows
navigate-env\Scripts\activate

# On Linux/Mac
source navigate-env/bin/activate

# Then install Navigate
pip install -e .[dev]

The same thing can be achieved using conda:

# Using conda
conda create -n navigate python=3.9.7
conda activate navigate
(navigate) C:\Users\Username\Code> cd navigate

# On Windows
(navigate) C:\Users\Username\Code\navigate> pip install -e .[dev]

# On Linux/Mac
(navigate) pip install -e '.[dev]'