Installing PyCharm

Created by Brahm Capoor with modifications by Nick Bowman and Chris Gregg

In CS5001 and CS5003, you will be writing code on your computer using an application called PyCharm. PyCharm is what is known as an IDE, or Integrated Development Environment, which means that it allows us to edit our code, browse our files, run our programs and debug them, all in the same place. It's one of the most popular Python IDEs in the world, and used extremely commonly in industry. This handout is intended to take you through installing PyCharm on your own computer.

Setting up

The Terminal

The Terminal, also sometimes called the Command Line or the Command Prompt on Windows, is a text-based interface for operating your computer. We'll be using it a bit throughout the semester in order to run our programs, so make sure you know how to open the Terminal on your computer. This website explains how to find the Terminal application on your computer, as well as some further details on what you can do with it. You don't need to worry too much about those details just yet, although you're free to peruse them if you'd like. As we go through the semester, we'll explore the capabilities of the terminal in much greater depth.

Installing Python

In order to be able to run Python programs on your computer, you need to install a Python Interpreter. An interpreter is a program that is capable of reading a .py file that you have written, and translating the Python code in that file to instructions that your computer can easily execute. Begin by downloading Python using the installers below.

Note: Even if you have previously installed Python before, you should go through this installation process to make sure that you have exactly the right version of Python installed that is required for this class.

Mac Installer
Windows 64-bit installer (If you're using a relatively new Windows computer, download this file)
Windows 32-bit installer (If you're using an older Windows computer, download this file)

Installing on a Mac

Note: Macs come with a version of Python installed, but this is an older version of Python (specifically, Python 2). CS5001/CS5003 requires the use of Python 3, so make sure to follow these instructions even if you think you already have Python installed. If you require the use of Python 2 for other work, you can still install Python 3, which exists alongside Python 2 rather than replacing it.

Open the downloaded Python installer file and follow the default instructions.
Open up your terminal application.
Type python3 and press enter. You should see something that looks like this:

              
Python 3.7.3 (default, Mar 27 2019, 09:23:15)
[Clang 10.0.1 (clang-1001.0.46.3)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

Installing on Windows

Open the downloaded file. Before installing, there should be an option that says "Add Python 3.7 in PATH". Make sure to check this box. Then, continue installing normally.
Open up the command prompt.
Type py and press enter. You should see something that looks like this:

              
Python 3.7.3 (v3.7.3:9a3ffc0492, Mar 27 2019, 09:23:15)
Type "help", "copyright", "credits" or "license" for more information.
>>>

Installing on Linux
Since there are so many different flavors of Linux, we cannot give detailed installation instructions. You should go ahead and install the most recent version of Python (3.7.3) using your friendly local neighborhood package manager, as well as the python3-tk package, which will install the graphical package that we will use during the semseter.

Installing and Testing PyCharm

Installation

To get started, download and install the community version of PyCharm:

Mac Download (Open the downloaded .dmg file and drag PyCharm into your Applications folder)
Windows Download (Open the downloaded .exe file and install PyCharm, using all the default options. )

Testing PyCharm

Now that you have PyCharm downloaded and installed, open it up and follow the setup wizard, which allows you to choose some default settings. Feel free to install any additional plugins it suggests, although none will be necessary for this class.

PyCharm models a program as a 'project', which consists of one or more Python files, as well as any additional resources like images or text files. To get you familiar with working with projects in PyCharm, we've provided a sample project, which you can download here. To test out this project, and to gain familiarity with the PyCharm environment, download the sample project, and unzip it (it will probably unzip into your Downloads folder in your home directory). Then, open it in PyCharm (using the 'open' option on the first screen). Make sure to open the folder that is called pycharm_intro.

See the demo video below to show how to open the project and configure it for your system:

Important note: If you are on a Windows computer, you may have a second pycharm_intro folder nested inside the outer pycharm_intro folder. Make sure to open the innermost pycharm_intro folder.

Note: If you see notifications pop up in the bottom right hand corner that say "Invalid VCS root mapping" or "No R interpreter found" you can safely ignore them.

Now, follow the steps below to run the project in PyCharm:

First, you need to configure the interpreter for the project, which essentially means that you want to specify the version of Python you'll be using to run your code. To do so, click 'configure Python Interpreter' at the top of your window:

Then, select the dropdown at the top of the window and click on your python 3.7 intrepeter:

Next, select "basic flower" from the configuration choices in the top left corner:

Now, you should be able to clickn on the green "run" button:

You should see a flower drawn on the screen -- we will learn how to do that during the first couple of classes!