Skip to content

Latest commit

 

History

History
75 lines (51 loc) · 3.08 KB

setup.md

File metadata and controls

75 lines (51 loc) · 3.08 KB
title
Setup

Requirements

Software

You will need a terminal, Python 3.8+, and the ability to create Python virtual environments.

::::::::::::::::::::::::::::::::::::::: callout

Installing Python

[Python][python] is a popular language for scientific computing, and a frequent choice for machine learning as well. To install Python, follow the Beginner's Guide or head straight to the download page.

Please set up your python environment at least a day in advance of the workshop. If you encounter problems with the installation procedure, ask your workshop organizers via e-mail for assistance so you are ready to go as soon as the workshop begins.

:::::::::::::::::::::::::::::::::::::::::::::::::::

Packages

You will need the MatPlotLib, Pandas, Numpy and OpenCV packages.

Setup

Create a new directory for the workshop, then launch a terminal in it:

mkdir workshop-ml
cd workshop-ml

{: .language-bash}

Creating a new Virtual Environment

We'll install the prerequisites in a virtual environment, to prevent them from cluttering up your Python environment and causing conflicts. First, create a new directory and ent

To create a new virtual environment ("venv") called "intro_ml" for the project, open the terminal (Max/Linux), Git Bash (Windows) or Anacomda Prompt (Windows), and type one of the below OS-specific options:

python3 -m venv intro_ml # mac/linux
python -m venv intro_ml # windows

{: .language-bash}

If you're on Linux and this doesn't work, you may need to install venv first. Try running sudo apt-get install python3-venv first, then python3 -m venv intro_ml {: .info}

Activate environment

To activate the environment, run the following OS-specific commands in Terminal (Mac/Linux) or Git Bash (Windows) or Anaconda Prompt (Windows):

  • Windows + Git Bash: source intro_ml/Scripts/activate
  • Windows + Anaconda Prompt: intro_ml/Scripts/activate
  • Mac/Linux: source intro_ml/bin/activate

Installing your prerequisites

Install the prerequisites:

pip install numpy pandas matplotlib opencv-python scikit-learn

{: .language-bash}

Deactivating/activating environment

To deactivate your virtual environment, simply run deactivate in your terminal or prompt. If you close the terminal, Git Bash, or Conda Prompt without deactivating, the environment will automatically close as the session ends. Later, you can reactivate the environment using the "Activate environment" instructions above to continue working. If you want to keep coding in the same terminal but no longer need this environment, it’s best to explicitly deactivate it. This ensures that the software installed for this workshop doesn’t interfere with your default Python setup or other projects.

Fallback option: cloud environment

If a local installation does not work for you, it is also possible to run this lesson in Google colab. If you open a jupyter notebook there, the required packages are already pre-installed.

{% include links.md %}