Skip to content

Latest commit

 

History

History
51 lines (31 loc) · 3.83 KB

mac.md

File metadata and controls

51 lines (31 loc) · 3.83 KB

Mac installation guide

0.1 Pre-req: installing Homebrew

Please follow the steps here to install Homebrew which is a package manager and installer for Mac. Note that installing Homebrew requires installing xcode first (included in the link) which takes a while. So grab a ☕ while waiting!

Afterwards, run brew update.

0.2 Pre-req: installing wget

Type brew install wget to install wget. wget is a tool that helps you download files from the internet to your machine.

0.3 Pre-req: installing python3

Ensure you have a working installation of python3 (in terminal, type python3 and hit enter to check). If you do not have a working installation of python3, we advice you to search mac python3 install on Google and follow the instructions there 👍.

1. Installing Anaconda

You can install Anaconda EITHER via the GRAPHICAL installer (clicky with mouse) OR the TERMINAL (type with keyboard). We've got you covered for both.

  1. (GRAPHICAL install) follow the steps listed on the official Anaconda installation guide under Installing on macOS > macOS graphical install.
    • After you're done with step 10, open up terminal and type conda config --set auto_activate_base False to prevent the conda base environment from being automatically activated each time you launch terminal. You may close the terminal afterwards.
    • Please go to bullet point 3 below and ignore bullet point 2.
  2. (TERMINAL install) follow the steps listed on the official Anaconda installation guide under Installing on macOS > Using the command-line install.
    • At step 7, select "yes" when prompted "Do you wish the installer to initialize Anaconda3 by running conda init?". We'll need this for step 11.
    • At step 11, type conda config --set auto_activate_base False to prevent the conda base environment from being automatically activated each time you launch terminal. You may close the terminal now.
  3. Wow, must've been a lot of steps and a lot of work 😓... BUT we're not yet done - we need to verify that your installation is working. Please open a new terminal and run conda activate base. You should see a (base) pop up beside your name in terminal if your installation was successful.
  4. Congratulations, you've installed Anaconda! 🎉🎉🎉

Why is there a (base) beside my name?

(base) beside your name means you've activated the Anaconda's base environment, where you have access to many data science packages (pip list to view).

Where are the jupyter notebook installation instructions?

By default, Anaconda's base environment ships with jupyter notebook. Run jupyter notebook in terminal to run the jupyter notebook server. Your local jupyter notebook website should automatically pop up in your favorite browser. To stop the server, press CTRL+C in terminal to terminate the running program.

2. Installing nodejs and npm

Yay, you're done with the hardest 💪 part of installing Anaconda 🐍. This part will be suuper easy in comparison! 😄 All you have to do is open up terminal and run this command by copying the whole command into your terminal and pressing enter (source):

brew update
brew install node

Now if you run npm --verson and node --version in terminal, your versions of npm and nodejs will be printed. This indicates a successful installation. See, I said it would be easy didn't I? 😉

What do I do now?

Now that you have all the tools you need installed, have a look at our project setup guide next!