Skip to content

Detailed instructions for installing runestone

Katie Cunningham edited this page Jan 10, 2017 · 2 revisions

These instructions for installing runestone assume that you may not be sure if you have Python installed, and that you may not be comfortable with the command line yet. That's totally fine!

##Step 0: Do you have Python already?

It's probably worth checking if you already have Python on your computer.

  • All Mac computers come with Python 2 already installed. But you may want to update your Python to the latest version by installing as described below.
  • Windows computers don't come with Python out of the box, but you may have installed Python for something in the past. To find out, search for "Python" in your search bar and see if something pops up.

Either way, we think it makes sense to install Python 2.7, as described below.

##Step 1: Install Python 2.7

Go to https://www.python.org/downloads/ and click the button to download Python 2.7.xx (the last numbers don't matter). Open the downloaded file to start the installation process. The defaults are good, except....

IMPORTANT NOTE FOR WINDOWS USERS: Choose the option to add Python to your PATH, as shown in the image below:

##Step 2: Become friends with your terminal

Advanced users often use something called the Terminal in order to interact more efficiently with their computer. If you are working on this ebook, you are now an advanced user.

On Macs, search for Terminal and open it. On Windows, search for Powershell and open it.

Type whoami and press enter. The prompt will return your username! Type pwd and press enter. The prompt will return your current location on your computer! Type ls and press enter. All the files in the current folder will be listed!

##Step 3: Use the terminal to install runestone

Now that you've got the hang of your terminal, we're going to use it to install runestone.

Type the following command in your terminal and press enter

pip install runestone

If there is a pause in the installation process when you are asked a question, you can press y to indicate yes.