1.4 Setting Up the PyCharm Environment

Introduction

PyCharm is a powerful Integrated Development Environment (IDE) specifically designed for Python.

Created by JetBrains, it offers many features, such as code completion, debugging tools, and version control integration, to streamline the development process.

In this section, we will cover the following:

1. Installation of the unified PyCharm product
2. Setup of your first Python project
3. Configuration of the Python interpreter
4. Running of your first Python script in PyCharm
5. Basic PyCharm features (code completion, debugging)

By the end of this section, you should have a functional PyCharm environment ready for Python development.

1.4.1 Recommended PyCharm Edition (Key Update)

PyCharm is now a single, unified product that offers both free core features and paid professional features.

Everyone downloads the same software, and what you pay for is access to the advanced tooling.

Recommendation: For this course, the Core Features (which include all the functionality of the former Community Edition plus new features like basic Jupyter support) are more than sufficient. The automatic 30-day Pro trial will give you access to everything, but you can continue using the necessary features for this course for free once the trial expires.

1.4.2 Downloading and Installing PyCharm

To install the unified PyCharm IDE, follow the steps below. Note that the installation does not require any form of payment:

Step 1: Visit the Official Website

In your browser, navigate to https://www.jetbrains.com/pycharm/download/.

You will see a single Download button for the unified PyCharm product. Click it.

Step 2: Run the Installer

Locate the downloaded file (e.g., pycharm-*.exe on Windows, .dmg on macOS, or .tar.gz on Linux).

Double-click or run the installer.

Step 3: Follow the Installation Wizard

• • Windows:
    • You may be prompted to select the installation path.
    • Optional: Choose to create a desktop shortcut or add PyCharm to the PATH.
    • Click “Next”, then “Install”.
  • macOS:
    • Drag and drop the PyCharm icon into your Applications folder.
    • Double-click PyCharm in Applications to launch it.
  • Linux (.tar.gz):
    • Extract the .tar.gz file.
    • Open the terminal inside the extracted folder and run ./bin/pycharm.sh.

Step 4: Launch PyCharm

On first launch, PyCharm will ask if you want to import settings. You can click No.

You will be prompted to accept the Privacy Policy and License Agreement. Accept and continue.

You will then be automatically enrolled in the 30-day Pro trial. Choose your UI theme (Light or Dark).

Done! PyCharm is now installed. Next, we will explore how to develop programs using the IDE.

1.4.3 Creating Your First Project in PyCharm

Step 1: Start PyCharm and Select “New Project”

When PyCharm opens, you will be presented with the Welcome screen.

Click on “New Project” button to begin.

Step 2: Configure Project Settings

• • Location: Choose a folder where you want to store your project. (e.g., C:/Users/Username/PyProjects/FirstProject)
  • Python Interpreter: If you’ve installed Python already (Chapter 1.3), PyCharm should auto-detect it. If it does not, click on “Add Interpreter” or “Existing Interpreter” to select your local Python installation.
  • Virtual Environment (Recommended): PyCharm creates a virtual environment by default to isolate your project’s dependencies. Always keep this selected to prevent library conflicts between different projects.

Step 3: Click on “Create”

PyCharm will set up the project structure and initialise the virtual environment. This process might take some minutes before it concludes.

1.4.4 Exploring the PyCharm Interface

Once the project is created, you should be presented with PyCharm’s main interface, which should include the following parts:

1. Project Tool Window (left side): Shows your files and folders.
2. Editor Area (centre): Where you write and edit your code.
3. Status Bar (bottom): Displays notifications and virtual environment details.
4. Run/Debug Toolbar (top right): Buttons to run and debug your code.
5. Console/Terminal Window (bottom): Where console output or interactive terminal appears.

1.4.5 Writing and Running Your First Python Script in PyCharm

Note that we discuss this task in more detail in the following section. If you find it difficult to understand what is being discussed here, you can ignore it and read the next section fully to understand the process.

Step 1: Create a Python File

In the Project Tool Window, right-click on your project folder → New → Python File.

Name the file hello.py (ensure it has the .py extension).

Step 2: Add Python Code

In hello.py, type:

def main():
    print("Hello, PyCharm!")

if __name__ == "__main__":
    main()

Step 3: Run the Script

Right-click inside the code editor → “Run ‘hello’”.

Or click the green Run triangle button at the top-right corner.

In the Run tool window (bottom), you will see:

Hello, PyCharm!

Success! You have executed your first Python script using PyCharm.

This stage is significant to the entire Python learning process.

Thus, if you have been able to complete this step, why not post a comment on the forum. If you are having problems with this, you have a few options. You could mention it in the forum first. If you do not receive sufficient help, then you can email the tutor at this link Tutor.

1.4.6 Configuring a Python Interpreter (If Needed)

If PyCharm didn’t auto-detect Python, you can manually configure it:

1. Open Settings:
   • File → Settings (Windows/Linux) or PyCharm → Preferences (macOS).
2. Navigate: Go to “Project: <your_project_name>” → “Python Interpreter”.
3. Add Interpreter: Click the gear icon → “Add…”
4. Select Environment Type:
   • Existing Environment: Choose the path to your installed Python (e.g., C:Python39python.exe).
   • Virtualenv: Let PyCharm create a clean, isolated environment. (This is the best solution for avoiding library conflicts).
5. Click OK or Apply to save changes.

1.4.7 Basic PyCharm Features

Here are a few important essentials of PyCharm that could boost your productivity:

1. Code Completion: Start typing and PyCharm will suggest variable names, functions, and modules. Press Tab or Enter to accept a suggestion.
2. Syntax and Error Highlighting: PyCharm will underline errors in red and warnings in yellow. Hover over the underlined text for details and suggested fixes (quick-fixes).
3. Refactoring Tools: Right-click on a variable or function name → Refactor to rename or move code without breaking references across your project.
4. Debugger: Set breakpoints by clicking in the left margin of the code editor. Use the Debug button (bug icon) to run your script line-by-line, allowing you to inspect variable values at each step.
5. Version Control Integration: PyCharm has built-in support for Git, GitHub, SVN, etc., allowing you to track changes and commit code directly within the IDE.

1.4.8 Tips for a Smooth PyCharm Experience

Here are a few PyCharm (or IDE) benefits that will help you in development.

1. Keyboard Shortcuts: Learn common shortcuts (e.g., Ctrl + Space for code completion, Ctrl + Shift + F for global search).
2. Themes and Fonts: Go to Settings → Appearance & Behaviour to customise the look and feel.
3. Plugins: Explore the Plugin Marketplace for additional features like Markdown support or advanced Docker integration.
4. Autoformatting: Use Code → Reformat Code (or press Ctrl + Alt + L on Windows/Linux, ⌥ + ⌘ + L on Mac) to keep your code clean and consistent.

Summary

Here is a summary of what we have covered in this section.

1. PyCharm Editions: Now a unified product with free core features and paid Pro features.
2. Installation: Download the single installer from the JetBrains website and follow the wizard.
3. Creating a Project: Use the Welcome screen → New Project, and select or create a virtual environment.
4. Interface Overview: Project pane, Editor, Status bar, Run/Debug tools, and Console/Terminal.
5. Running Code: Create a .py file, type code, click Run.
6. Key Features: Code completion, debugger, version control, and refactoring tools.

With PyCharm set up, you are now ready to develop Python applications more efficiently. Again, this stage is very significant. Once you can get across this stage, it is more straightforward to develop your Python programs. Get in touch with the tutor if you have problems installing PyCharm. Note that only the first few registrants might be able to get direct assistance on this.

What’s Next?

In the next section, we shall discuss more broadly on how to run your first Python program.