Installing on MacOS

Atom & Sync Settings

  1. Download Atom, extract the zipped file, then drag the Atom application to your Applications folder. Next, open up Atom.

  2. Open Atom settings by going to Atom > Preferences (or Control + Comma).

  3. Go to Install and search for sync-settings. Click on the blue Install button in the sync-settings box.

  4. Once it’s done installing, click on the Settings button in the sync-settings box.

  5. Create a new Github personal access token. You may set the name to anything you’d like, but we recommend that you call it something descriptive, like “aguaclara-atom-configuration”.

  6. Check the “gist: Create gists” permission, then click Generate Token. Copy the generated token.

  7. In the Atom sync-settings settings, paste your generated token in Personal Access Token.

  8. Set the Gist Id to 8cb1fed2721e41873e9bcb315c804579.

  9. Restart Atom. sync-settings will do its job in the background. You can check on its progress in File > Settings > Packages.

    • If you get a dialog box saying that sync-settings is out of date, click “Restore”.

Git

  1. Open Terminal and enter the following command:

    • git --version

  2. If you don’t alread have Git, Xcode will prompt you to install it. Follow the prompts to install Git.

  3. Open Terminal and un the two following commands with your name and Cornell email, carefully observing spaces and punctuation:

    • git config --global user.name "Firstname Lastname"

    • git config --global user.email "NetID@cornell.edu"

      • The quotation marks are important! For example, the command should say something like git config --global user.name "Monroe Weber-Shirk".

Anaconda & Python

  1. Download the Anaconda installer and double-click it to begin installation.

  2. When the installer displays Advanced Options, select “Add Anaconda to my PATH environment variable”.*

    • Aside from this, you can just click “Next” through the entire installation.

* If the installer did not give the option to “Add Anaconda to my PATH environment variable”, follow the steps below after the installation:

  • Open Terminal and enter which python

  • Copy the directory the terminal outputs. (This is the directory Python has been installed in.)

  • Enter the command export PATH=$PATH<directory>, replacing <directory> with the directory you copied above.

pip Packages

  1. Open Terminal, as you did when installing Git.

  2. Run the following command, carefully observing spaces and punctuation:

    • pip install aguaclara --user

      • If you get the error bash: pip: command not found, follow the steps in the Anaconda and Python section after the asterisk.

Now, you’re ready for Installing Interactive Tutorials.