Setup the FUSE environment
Julia installation
We highly recommend using the Juliaup manager to install Julia
- Mac & Linux:
curl -fsSL https://install.julialang.org | sh
- Windows:
winget install julia -s msstore --accept-source-agreements --accept-package-agreements
Once installed, restart your termninal to pick-up the julia
executable.
FUSE installation
FUSE and related packages are registered at the FuseRegistry. For installation start your Julia interpreter by typing julia
at the terminal, then:
Add the
FuseRegistry
and theFUSE
package as you would for any other julia package (for a fresh install this can take 20+ mins):using Pkg Pkg.Registry.add(RegistrySpec(url="https://github.com/ProjectTorreyPines/FuseRegistry.jl.git")) Pkg.Registry.add("General") Pkg.add("FUSE")
Now you should be able to import the FUSE package:
using FUSE
Install the
fusebot
utility to simplify install/updates later on. Nowfusebot
should be a command that you can type anywhere from the terminal.FUSE.install_fusebot()
Run the regression tests (optional, this can take 1h+)
julia ] test FUSE
Exit julia and clone
FUSE examples
in the current working directory. To see/run those.ipynb
files, you'll need to use Jupyter-Lab or VScode.fusebot install_examples
Install Jupyter-Lab with Julia support
You will need to install
jupyter-lab
if that's not already available on your systemInstall the
IJulia
package by running:fusebot install_IJulia
Note This will setup the single- and multi-thread julia kernels in Jupyter.
The number of threads of the multi-threaded julia kernels can be set via the
JULIA_NUM_THREADS
environmental variable.This needs to be done every time a new version of Julia is installed.
Start a new Jupyter-lab session (this should open a web-browser page with Jupyter running)
jupyter-lab
Now you can browse the examples in the
FuseExamples
folder that you have cloned, and take a tour of the example Jupyter notebooks there.
Updating FUSE
Get notified of new FUSE releases by "watching" the FUSE repo on GitHub
FUSE is updated like any other Julia package:
julia ] up
Become familiar with how managing Julia packages works.
Updating Julia
Use
juliaup update
to install the latest version of JuliaInstall FUSE to the new version of Julia
using Pkg Pkg.add("FUSE")
Run
fusebot install_IJulia
to install the Kernel for the latest version of Julia in Jupyter-Lab