Skip to content

Prerequisites

Nikoleta Glynatsi edited this page Aug 26, 2024 · 4 revisions

Please make sure you install all the necessary software before the workshop and that you have access to GitHub.

  • GitHub
  • Git
  • Python
  • Editor

GitHub

In this workshop we will use GitHub. You can create an account by navigating to GitHub: http://github.com. If you are in education, you can apply for a specific education account here: https://education.github.com.

Once you have created a GitHub account you should set up an ssh key: https://github.com/Nikoleta-v3/HitchCos/wiki/ssh-key.

Git

Git is the version control software used in the workshop.

Installation

  1. Go to the following link and choose the correct version for your operating system: https://git-scm.com/downloads.
  2. After downloading, run the installer as usual on your machine.
    • Windows: You may leave all options at their default values during installation.

Checking Installation

You can verify that Git has been successfully installed:

  1. Open a terminal or command prompt and type git. Press [Enter] to execute the command.

If Git is installed, you should see usage information.

For Windows

  1. In the Search bar, type git-bash and start the git-bash executable. This will open a terminal window.

If you cannot locate the git-bash launcher, go to "Start Menu -> Git -> Git Bash". You may want to create a shortcut on the Desktop or add it to the taskbar.

  1. In the terminal, type:

    $ git

    and observe the output.

This version includes minor adjustments for clarity and consistency.

Editor

There are several editors that allow us to edit files such as python scripts, LaTex files etc. For this workshop the suggested editor is VS code.

If you prefer to use a different editor skip this part.

Installation

Install python extension for VSCode

  • Open VS code.
  • Bring up the Extensions view by clicking on the Extensions icon in the Activity Bar on the side of VS Code.
  • There type "Python" and select and install the first hit returned from the search.

Python

To install Python we recommend Anaconda. Anaconda is a Python distribution (similar as how Ubuntu is a distribution of Linux). It bundles the python interpreter with numerous libraries, addons, and development environments such as Jupyter.

Installation

IMPORTANT

Modify the PATH environment variable as suggested.

Test your Python installation

In a terminal window (Windows: git-bash), enter the command

$ python -c "import sys; print(sys.version)"

If you already had your terminal/git-bash open from the previous step you will have to close it and open it again before you test your Python installation.