Skip to content

jbrea/MLCourse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Nov 26, 2024
e21854c · Nov 26, 2024
Sep 14, 2022
Aug 23, 2024
Sep 7, 2021
Aug 23, 2024
Nov 26, 2024
Aug 25, 2023
Aug 8, 2021
Dec 13, 2022
Oct 4, 2024
Sep 14, 2022
Aug 23, 2024
Sep 13, 2024
Aug 8, 2021
Aug 23, 2024
Aug 23, 2024
Sep 20, 2023
Sep 11, 2023

Repository files navigation

MLCourse

This repository contains teaching material for an introductory machine learning course.

Students of my course do not need to pull this repository or follow the instructions below. This repository is mostly used to create the interactive websites on https://bio322.epfl.ch.

Installation

To use the code, we recommend downloading Julia version 1.9.3 with juliaup.

Windows

1. Install juliaup

winget install julia -s msstore

2. Add Julia 1.9.3

juliaup add 1.9.3

3. Make 1.9.3 default

juliaup default 1.9.3
Mac

1. Install juliaup

curl -fsSL https://install.julialang.org | sh

You may need to run source ~/.bashrc or source ~/.bash_profile or source ~/.zshrc if juliaup is not found after installation.

Alternatively, if brew is available on the system you can install juliaup with

brew install juliaup

2. Add Julia 1.9.3

juliaup add 1.9.3

3. Make 1.9.3 default

juliaup default 1.9.3
Linux

1. Install juliaup

curl -fsSL https://install.julialang.org | sh

You may need to run source ~/.bashrc or source ~/.bash_profile or source ~/.zshrc if juliaup is not found after installation.

Alternatively, use the AUR if you are on Arch Linux or zypper if you are on openSUSE Tumbleweed.

2. Add Julia 1.9.3

juliaup add 1.9.3

3. Make 1.9.3 default

juliaup default 1.9.3

4. Installing MLCourse

Once you have finished the above steps 1.-3. for your operating system, launch julia and run the following code to install the course material.

julia> using Pkg
       Pkg.activate(temp = true)
       Pkg.develop(url = "https://github.com/jbrea/MLCourse")
       Pkg.activate(joinpath(Pkg.devdir(), "MLCourse"))
       Pkg.instantiate()
       using MLCourse
       MLCourse.start()

Many packages and binaries are downloaded in the Pkg.instantiate() step. If you encounter an error message like ERROR: Unable to automatically install 'sysimage' or ERROR: failed to clone from ... rerun Pkg.instantiate() a moment later.

Usage

Once MLCourse is installed, you can open the notebooks in a Julia REPL anytime with

julia> using Pkg; Pkg.activate(joinpath(Pkg.devdir(), "MLCourse"))
       using MLCourse
       MLCourse.start()

You can update the course material with

julia> using Pkg; Pkg.activate(joinpath(Pkg.devdir(), "MLCourse"))
       using MLCourse
       MLCourse.update()