First, we will install the package manager homebrew
.
The shell you use is probably bash
, but it may be something different like zsh
(especially on OS X). You should be able to check your shell with:
echo $SHELL
If is gives /bin/bash
, then you are using bash
, if it gives something else like /bin/zsh
then you may need to change where the notes say ~/.bash_profile
below to ~/.zsh_profile
. If the notes don't work for that, use ~/.bashrc
below to ~/.zshrc
instead of ~/.bash_profile
or ~/.zsh_profile
.
Take note of which profile
file you need to use for actions below and be aware of the options.
If you are working on a linux system and don't have root access (you are a user on a multi-user system) you can install brew as a user:
mkdir -p ${HOME}/homebrew && curl -L https://github.com/Homebrew/brew/tarball/master | tar xz --strip 1 -C ${HOME}/homebrew
Here, we have installed brew
in ${HOME}/homebrew
, so you will need to add that directory to your PATH
below.
First, install homebrew
:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
Note that on OS X brew
needs the Xcode
compiler Command Line Tools
which can take a little time to download if yo dont have it installed. It is possible that the script can fail a first time, but if it does, just try re-running it.
Read the information that happens when you install brew
. It should say something like:
==> This script will install:
/opt/homebrew/bin/brew
which means you need to make sure /opt/homebrew/bin
is in your PATH
. It might say /usr/local/bin
instead of /opt/homebrew/bin
, so pay attentioopn to that.
You should know which profile file you need from above. It will probaby be ~/.bash_profile
or ~/.zsh_profile
, but you may need to use ~/.bashrc
or ~/.zshrc
.
You should know the directory that brew
was installed. This will probably be /usr/local/bin
or /opt/homebrew/bin
or ${HOME}/homebrew
.
Then type one of the following as appropriate:
echo 'PATH="${HOME}/homebrew:${PATH}"' >> ~/.bash_profile
or
echo 'PATH="/opt/homebrew/bin:${PATH}"' >> ~/.zshrc
or
echo 'PATH="/usr/local/bin:${PATH}"' >> ~/.bash_profile
or similar, as appropriate.
Now, we can test this. Open a new shell: either open a new terminal or type bash
(or zsh
) in the current terminal, as appropriate.
Test brew
:
brew install hello
If that fails, check that you used the right file ~/.zsh_profile
or ~/.bash_profile
above for your shell and that you opened a new shell. Don't try to go further until you have this sorted. If you need help, contact the course tutor.
For Windows, if you use WSL-Windows System for Linux
, then you should be able to install and use brew
as above. There is a good tutorial for that here. If you use this though, you need to also install all of the packages in WSL
and run jupyter from there. There is a good tutorial on that here.
Otherwise, you might try some advice from the web.