PyCharm Guides

Step-by-step guides for PyCharm, the Python IDE from JetBrains: installing it, setting up interpreters and virtual environments, installing packages, running and debugging code, and the shortcuts and plugins that speed up daily work. New to PyCharm? Follow the six steps below in order.

Showing all 38 guides

Your first PyCharm project in six steps

The order most people follow on day one, with the menu path for each step and the guides that go into detail.

  1. Install PyCharm

    Download the installer from JetBrains or use the Toolbox App, which also handles updates.

    jetbrains.com/pycharm/download

  2. Create a project

    Pick a folder and keep the default virtual environment, so the project gets its own packages.

    File > New Project

  3. Check the interpreter

    Confirm which Python version the project runs on, or add another one.

    Settings > Project > Python Interpreter

  4. Install packages

    Add libraries from the Python Packages tool window, or with pip in the built-in terminal.

    View > Tool Windows > Python Packages

  5. Run, debug and test

    Run the file, set a breakpoint to step through it, and run your tests with pytest.

    Right-click the file > Run

  6. Share it on GitHub

    Put the project under version control and publish it to a GitHub repository.

    Git > GitHub > Share Project on GitHub

Menu paths are for the current PyCharm interface. On Windows and Linux, Settings is under File; on macOS it is under PyCharm.

PyCharm shortcut finder

Default keymap. Windows and Linux share the same keys; switch to macOS to see the Mac version.

ActionWindows and LinuxmacOSGuide
Search EverywhereShift Shift⇧ ⇧
Find an action by nameCtrl+Shift+A⇧⌘A
Open settingsCtrl+Alt+S⌘,Set up PyCharm
Open the terminalAlt+F12⌥F12Open the terminal
Run the selected configurationShift+F10⌃RRun code
Run the file in the editorCtrl+Shift+F10⌃⇧RRun code
Debug the selected configurationShift+F9⌃DDebug in PyCharm
Toggle a breakpointCtrl+F8⌘F8Debug in PyCharm
Step overF8F8Debug in PyCharm
Step intoF7F7Debug in PyCharm
Comment or uncomment the lineCtrl+/⌘/Comment code
Block commentCtrl+Shift+/⌥⌘/Comment code
UndoCtrl+Z⌘ZUndo in PyCharm
RedoCtrl+Shift+Z⇧⌘ZUndo in PyCharm
Reformat codeCtrl+Alt+L⌥⌘L
Optimize importsCtrl+Alt+O⌃⌥O
Show quick fixesAlt+Enter⌥↩
Duplicate the lineCtrl+D⌘D
Delete the lineCtrl+Y⌘⌫
Rename a symbolShift+F6⇧F6
Go to declarationCtrl+B⌘B
Find usagesAlt+F7⌥F7
Recent filesCtrl+E⌘E
Commit changesCtrl+K⌘KConnect to GitHub
Push commitsCtrl+Shift+K⇧⌘KConnect to GitHub

Zooming has no default key. Turn on Settings > Editor > General > Change font size with Ctrl+Mouse Wheel, or follow How to zoom in PyCharm. The full list is in PyCharm keyboard shortcuts.

Install and set up

9

Choose between the free core and the Pro subscription, install PyCharm on Windows, macOS or Linux, and keep it up to date.

What Is PyCharm: A Beginner’s GuideJetBrains makes PyCharm, a Python IDE that analyzes your code while you type. Completion, refactoring, debugging, testing, and environment management all sit…18 min read Updated PyCharm Community vs Professional: Which Should You Pick?Picking the wrong PyCharm edition costs you either money or productivity. The PyCharm Community vs Professional debate comes down to one question:…17 min read Updated How to Install PyCharm on WindowsDownload the .exe installer from JetBrains, run the wizard, and open PyCharm from the Start menu or the desktop shortcut. That covers…13 min read Updated How to Install PyCharm on Mac: Beginner’s GuideGetting your Python environment up and running on Mac takes less than ten minutes. But only if you know which build to…14 min read Updated How to Install PyCharm on LinuxJetBrains lists the Toolbox App as its recommended way to install PyCharm on Linux. Snap works as well, but the same guide…18 min read Updated How to Setup PyCharm for Your ProjectsPyCharm installs the same way on Windows, macOS and Linux. The installer is the quick part. Most of the time goes into…21 min read Updated How to Use PyCharm: Tips for BeginnersCommunity and Professional merged into a single PyCharm in version 2025.1, and the free core now includes Jupyter Notebook support (JetBrains documentation,…21 min read Updated How to Update PyCharm to the Latest VersionOpen Help | Check for Updates (PyCharm | Check for Updates on macOS), accept the patch it offers, and restart the IDE.…17 min read Updated How to Uninstall PyCharm Without Leaving TracesClicking “Uninstall” isn’t enough. Not with PyCharm. Most developers who uninstall PyCharm walk away thinking the job is done, only to find…16 min read Updated

Interpreters, environments and packages

8

Every PyCharm project runs on an interpreter, usually inside a virtual environment. These guides cover choosing one and installing packages into it.

How to Add Python Interpreter in PyCharmIn PyCharm, press Ctrl+Alt+S to open Settings, go to Python | Interpreter and click Add Interpreter. Choose Add Local Interpreter, then pick…17 min read Updated How to Change Python Version in PyCharmTo change the Python version in PyCharm, click the Python Interpreter selector in the status bar and pick an interpreter built on…14 min read Updated How to Create a Virtual Environment in PyCharmMaking a virtual environment in PyCharm happens mostly in the New Project dialog. Open File > New Project, choose Project venv, and…14 min read Updated How to Install Pip in PyCharm ExplainedTo install pip in PyCharm, run python -m ensurepip –upgrade in the Terminal tool window while the project interpreter is active. Most…13 min read Updated How to Install Libraries in PyCharm FastInstalling a library in PyCharm starts in the Python Packages tool window. Search for the package name, click Install, and pick a…14 min read Updated How to Install Pandas in PyCharm GuideOpen the Python Packages tool window, type pandas in the search field and click Install. PyCharm puts the package into the interpreter…12 min read Updated How to Install NumPy in PyCharm EasilyIn the Python Packages tool window, search for numpy and click Install. PyCharm adds the package to the interpreter selected for the…14 min read Updated How to Install PyGame in PyCharm QuicklyIn PyCharm, pygame goes in through the Python Packages tool window. Search for it, click Install, and you’re done. The library lands…14 min read Updated

Projects and GitHub

3

Create and remove projects, and connect them to a GitHub repository.

Running, debugging and testing

5

Run scripts, step through them with the debugger, run pytest, and work in the terminal or a Jupyter notebook.

Editing, shortcuts and plugins

5

Comment, undo and zoom, learn the keys you’ll use every day, and add plugins.

Coding assistants in PyCharm

2

Connect Claude Code and Codex to PyCharm and use them on a real project.

PyCharm vs other tools

6

How PyCharm compares with VS Code, IntelliJ IDEA, Spyder, Jupyter, Anaconda and Sublime Text.

Frequently asked questions

Is PyCharm free?

PyCharm’s core Python features are free. In 2025 JetBrains merged Community and Professional into one product: the free tier covers editing, running, debugging and testing Python, and a Pro subscription unlocks web frameworks, databases, remote development and data science tools.

How do I add a Python interpreter in PyCharm?

Open Settings, go to Project > Python Interpreter, click Add Interpreter, and choose a virtual environment, a system interpreter or a conda environment. On macOS, Settings is under the PyCharm menu.

Does PyCharm create a virtual environment automatically?

Yes. By default, the New Project dialog creates a virtual environment inside the project folder, so packages you install stay with that project.

What is the most useful PyCharm shortcut?

Press Shift twice to open Search Everywhere. It finds files, classes, symbols, settings and actions from one box, so you rarely need the menus.

PyCharm or VS Code?

PyCharm is an IDE built for Python, with refactoring, test runners and project tools ready out of the box. VS Code is a lighter general-purpose editor that you extend for Python. Both handle virtual environments, debugging and testing well.

These guides are written by Bogdan Sandu and published by TMS Outsource, a custom software development company founded in 2014, with engineering offices in Belgrade and Bucharest. If you need a team to build or extend a web or mobile product, see our software development services or get in touch.