These directions will guide you through the installation of Python 3 using Anaconda, an installation of the PyCharm IDE, and the creation and editing of a “Hello World!” project in PyCharm.
For this course we will be using Python 3. These instructions will be written for the latest version of Python—at the time of this tutorial 3.8.5.
We will be installing Python 3 through Conda. Conda is an open source package that creates and manages Python environments on your computer.
Conda is included in an installation of Anaconda as an open-source Python/R data science platform. Conda can also be installed with Miniconda—a lightweight Python wrapper of Conda. This tutorial will walk you through an installation of Python 3 and Conda through Anaconda.
Download the Anaconda Python 3.8 installer for your operating system available here.
Depending on your platform, the instructions to install Anaconda will be graphical or command-line based. Either method will work as long as it compatible with your system.
Once installed, open a terminal window and test that Anaconda and Conda was installed correctly by entering the command conda --version
. Your terminal output should look similar to the following
(base) $ conda --version
conda 4.9.2
The (base)
indicates the current Python environment is currently set to the base environment installed with Anaconda/Conda. Which means that the current Python version should be set to Python 3. We can check this with the command python --version
:
(base) $ python --version
Python 3.8.5
Next, check that the Python path is set to Anaconda’s using the command which python
:
(base) $ which python
/Users/compsci260/anaconda3/bin/python
Note that if using the GUI installer, the path will be /Users/compsci260/opt/anaconda3/bin/python
.
With this (base)
environment of Python 3, we are ready to build Python 3 projects. However, for practicality, we will want to create an environment specifically for this course. Create the Conda environment named compsci260
using the conda create
command.
conda create --name compsci260 python=3.8.5
You will be prompted to install packages into this environment. Confirm and proceed by entering y
.
Verify that your Conda environment has been installed by listing out the available Conda environments using the command conda env list
:
(base) $ conda env list
# conda environments:
#
base * /Users/compsci260/anaconda3
compsci260 /Users/compsci260/anaconda3/envs/compsci260
We’ve successfully created the compsci260
environment and we can switch to it using the conda activate compsci260
command.
(base) $ conda activate compsci260
(compsci260) $
We can also switch back to the system Python using the command conda deactivate
.
In the subsequent parts, we will show how we can integrate our compsci260
environment into Python projects with PyCharm.
Although students are may use whichever IDE they are comfortable with, we will provide instructions and support for the JetBrains IDE PyCharm.
With an .edu
email, JetBrains allows students to obtain many products for free including PyCharm Professional. Link available here
Although this version is not required over PyCharm Community, PyCharm Professional provides additional features including a profiler, scientific tools, and web development integration.
Download and install the PyCharm for your operating system. Link available here
Open the new installation of PyCharm and select Create New Project
:
Select Pure Python
project and specify a location to create the project. In this example we chose to create a directory named HelloWorld
.
Next, we will need to setup the project to use our Conda environment’s Python interpreter. Select Existing Interpreter
and navigate to the add interpreter view with the ...
button:
Add the Python intepretor from the compsci260
conda environment we setup earlier. Select Make available to all projects
for future projects. Select OK
, then Create
to create the new project.
Tip: If you can’t find the path to the Python executable, activate the environment in a terminal using conda activate compsci260
and find the python executable path with which python
.
Now create a new Python file in the project by right-clicking the HelloWorld project, selecting New
and Python File
. Call this file hello.py
In the body of the file type:
print("Hello World!")
Before we can run, we need setup a run configuration to define how we will run the project. From the menu, select Run -> Edit Configurations
:
Select the +
sign and add a new Python
run configuration. In the script path, navigate to the hello.py
we just created. The Working Directory
should also auto-populate with the project’s full path. Verify the Python Interpreter is version 3.8 from our compsci260 environment. Select OK
.
In the menu, select Run -> Run 'hello'
. The Python script will execute and the console should output:
/Users/compsci260/anaconda3/envs/compsci260/bin/python /Users/compsci260/HelloWorld/hello.py
Hello World!
Process finished with exit code 0
Congratulations! You’ve run your first Python project in PyCharm using a Conda environment.
Opening an existing Python project is very similar to creating a New Project. Close any open PyCharm windows and the Welcome to PyCharm
window should appear.
Select Open
and navigate to an existing projects directory and select Open
. Ensure you are opening the directory not a specific Python file in the directory.
If this it the first time opening the project in PyCharm, we need setup a run configuration to define how we will run the project. From the menu, select Run -> Edit Configurations
:
Select the +
sign and add a new Python
run configuration. In the script path, navigate to the hello.py
we just created. The Working Directory
should also auto-populate with the project’s full path. Verify the Python Interpreter is version 3.8 from our compsci260 environment. Select OK
.
In the menu, select Run -> Run 'hello'
. The Python script will execute and the console should output:
/Users/compsci260/anaconda3/envs/compsci260/bin/python /Users/compsci260/HelloWorld/hello.py
Hello World!
Process finished with exit code 0
Congratulations! You’ve open and run an existing Python project in PyCharm using a Conda environment.