Setting Up Your Python Environment

Okay, enough theory. Let's get our hands dirty.

Before you can write and run Python code, you need two things:

1. Python itself — the engine that runs your code
2. VS Code — a code editor that makes life a whole lot easier

Let me walk you through both, step by step.

Table of Contents

• Installing Python
• Installing VS Code
• Quick Test — Is Everything Working?
• Troubleshooting Common Setup Issues

Installing Python

Step 1: Download Python

Head over to the official Python website:

https://www.python.org/downloads/

The site will automatically suggest the latest version for your operating system. At the time of writing, that's Python 3.13 or newer. Don't download Python 2.x — that's ancient history.

Quick tip: If you're on Windows, look for the big yellow button that says "Download Python 3.x.x". You can't miss it.

Step 2: Run the Installer

Here's the most important part — check the box that says "Add Python to PATH".

I cannot stress this enough. I've seen so many beginners skip this step and then wonder why python doesn't work in their terminal. Check that box before clicking "Install Now". It's right there on the first screen of the installer — you can't miss it.

Step 3: Verify the Installation

Open a terminal (Command Prompt on Windows, Terminal on Mac/Linux) and type:

python --version

You should see something like:

Python 3.13.2

If you see a version number, congratulations — Python is installed!

If you get an error like 'python' is not recognized, try:

py --version

On some Windows systems, py is the launcher command. If that works too, you're good to go.

Step 4: Install pip (It's Probably Already There)

pip is Python's package manager — you use it to install extra libraries. It usually comes bundled with Python, but let's make sure:

pip --version

You should see something like pip 24.x.x. If not, don't panic. We'll deal with it when we get there.

Installing VS Code

Python comes with a basic editor called IDLE, but trust me — you'll want something better. VS Code (Visual Studio Code) is the most popular code editor for Python, and it's free.

Step 1: Download VS Code

Go to:

https://code.visualstudio.com/download

Pick the version for your operating system (Windows, Mac, or Linux).

Step 2: Run the Installer

The default settings are fine for most people. But here's what I recommend during installation:

• Add "Open with Code" action — check this
• Add to PATH — check this (makes life easier)
• Register as default editor — optional, but nice

Step 3: Install the Python Extension

This is where VS Code really shines for Python development.

1. Open VS Code
2. Click on the Extensions icon on the left sidebar (looks like four little squares, or press Ctrl+Shift+X)
3. Search for "Python"
4. Find the one by Microsoft (it's the official one)
5. Click Install

This extension gives you:

• Syntax highlighting — your code looks colorful and readable
• IntelliSense — VS Code suggests what to type next
• Run button — one-click code execution
• Debugger — step through your code line by line

Step 4: Create Your Workspace

Create a folder somewhere on your computer where you'll keep all your Python files. Something like:

• C:\PythonProjects (Windows)
• ~/PythonProjects (Mac/Linux)

Then in VS Code, go to File → Open Folder and pick that folder. This becomes your workspace.

Quick Test — Is Everything Working?

Let's do a quick sanity check before we move on.

Create a new file in VS Code:

1. Press Ctrl+N (or Cmd+N on Mac) — creates a new file
2. Type this:

print("Python is ready!")

3. Press Ctrl+S to save — name it test.py
4. Click the Run button (triangle icon) in the top right corner

You should see the output Python is ready! appear in a terminal panel at the bottom.

If that worked — everything is set up correctly! Give yourself a pat on the back.

Troubleshooting Common Setup Issues

"python is not recognized as a command"

You missed the "Add Python to PATH" checkbox. Fix it:

1. Uninstall Python from Control Panel / Settings
2. Reinstall — and this time, actually check that box
3. Restart your terminal

"I can't find the Run button in VS Code"

Make sure you installed the Python extension by Microsoft. Without it, VS Code treats .py files as plain text.

VS Code says "No Python interpreter selected"

Press Ctrl+Shift+P, type Python: Select Interpreter, and pick the Python version you installed.