---
title: Guide for Interns on Getting Started
tags: PTI, python
---
# Guide for Interns on Getting Started
This page: https://hackmd.io/@marionalberty/PTIinterns

Note that throughout this document I denote lines to be typed in a [terminal/shell](https://swcarpentry.github.io/shell-novice/) by starting them with a dollar sign ( `$` ); the dollar sign is not to be typed as part of the command.

## Fork the project repository from Github
Now we're going to [fork](https://docs.github.com/en/github/getting-started-with-github/quickstart/fork-a-repo) the project repository, [CFR-2024](https://github.com/PrisonTeachingInitiative/CFR-2024), from Github.

To start, open a browser (Chrome is a good option) and navigate to the [CFR-2024 Github page](https://github.com/PrisonTeachingInitiative/CFR-2024) and click the click the 'fork' button on the main page. One the next page, click the green 'Fork' button at the bottom of the page. Once you've forked the project repository, you will have a copy on your github account.

Now we need to get that on to your laptop, which is called cloning. To clone your fork of *CFR-2024*, open a Git Bash shell by clicking the Git Bash icon on your desktop.

Then enter the following commands. Replace the text in quotes with your own username and the email you used for github.

$ cd Desktop
$ git config --global user.name "your_github_username"
$ git config --global user.email "your_github_email"
$ git config --global credential.helper cache

with your GitHub username instead of `YOUR-USERNAME`

$ git clone https://github.com/YOUR-USERNAME/CFR-2024.git

Now if you enter `ls`, `CFR-2024` will be listed as a folder with all the other folders you have on your Desktop directory.

Next we'll connect your repository to the original one so you can easily get any changes that PTI make. Start by moving into your new repository

$ cd CFR-2024
$ git remote -v

You'll see a list of the current remote repositories (on Github) that you're connected to. These will be labeled `origin`. Next enter

$ git remote add upstream https://github.com/PrisonTeachingInitiative/CFR-2024.git

To ensure that was added enter `git remote -v` again.

You should get an output that looks like:

origin  https://github.com/YOURUSERNAME/CFR-2024.git (fetch)
origin  https://github.com/YOURUSERNAME/CFR-2024.git (push)
upstream        https://github.com/PrisonTeachingInitiative/CFR-2024.git (fetch)
upstream        https://github.com/PrisonTeachingInitiative/CFR-2024.git (push)

Here is a visual representation of the connections you've just set up between your laptop, the original version of the CFR repository (here labeled 'upstream') and your own version of the repository that's tied to your github account (here labeled 'origin').

## Launching Jupyter-Lab
Find the Anaconda Navigator icon on your laptop and launch the application.

Find the button for Jupyter Notebooks and launch that.

In the file tree, click 'Desktop' then 'CFR-2024'.