Skip to content

macOS

1. Install Conda

If you do not already have Conda installed, we recommend installing Miniconda, a lightweight version of Anaconda.

Steps

  1. Go to the Anaconda download page.
  2. Sign in or create an account if prompted.
  3. Open the Distribution section.
  4. Download Miniconda for your operating system.
  5. Run the installer and follow the instructions.

To verify that Conda was installed correctly, open a terminal and run:

conda --version

This should display the installed Conda version number.

2. Install Git

If you do not already have Git installed, the easiest way is via Homebrew.

If you do not have Homebrew yet, install it first:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Then install Git:

brew install git

3. Install VS Code

If you do not already have Visual Studio Code (VS Code) installed, please install it as your editor for the course.

Steps

  1. Go to the official VS Code download page.
  2. Download the installer for your operating system (Windows, macOS, or Linux).
  3. Follow the installation instructions for your platform.
  4. Launch VS Code once installation is complete.

To verify that VS Code was installed correctly, open the application successfully.

4. Clone the Course Repository

You will need a local copy of the course GitHub repository to access the course materials and the environment file.

Steps

  1. Open VS Code.
  2. On the start screen, click Clone Git Repository.
  3. When prompted, enter the repository URL:
https://github.com/sib-swiss/federated-learning-training.git
  1. Choose the folder where you would like to save the course files.
  2. Once the download is complete, click Open to open the repository in VS Code.

5. Set Up the Environment

We provide a Conda environment file that installs all required packages for the exercises.

Steps

  1. If it is not already open, open VS Code and load the cloned federated-learning-training folder.
  2. Open a terminal in VS Code via Terminal > New Terminal.
  3. Run the following command:
conda env create -f fl-course-env.yaml

This may take a while.

  1. Once the installation is complete, activate the environment:
conda activate fl-course-env
  1. In VS Code, select the fl-course-env interpreter if prompted.

Once activated, your terminal prompt should show the environment name at the beginning of the command line, for example:

(fl-course-env) your-name@your-computer federated-learning-training %