DEV Community

Cover image for Python Installation Guide (Windows, Mac, Linux) – The Easy Way
Khawaja Khurram (MAK)
Khawaja Khurram (MAK)

Posted on Originally published at makuistudio.com

Python Installation Guide (Windows, Mac, Linux) – The Easy Way

Note: This article was originally published on MAK Studio. Check out the full guide with screenshots and troubleshooting tips here: How to Install Python.

Getting Python running on your machine is the first, and often most frustrating, hurdle for new developers. In 2026, the process is actually straightforward if you know the right steps.

I've set up Python environments on dozens of machines. Here's the process that works every time, on every OS.

Why Python?

Python remains the top choice for AI, data science, and automation. The Stack Overflow Developer Survey and GitHub's Octoverse report consistently show it as one of the fastest-growing and most loved languages. If you're starting out, Python is the most accessible and in-demand choice.

Step 1: Download the Installer

Go to the official source: python.org/downloads.

The site will detect your OS and offer a big yellow download button. Click it.

⚠️ Important Note for Windows: On the first screen of the installer, make sure to check the box that says "Add Python to PATH". This is the single most common mistake. If you miss this, you'll have to install it again or manually configure your system environment variables.

Step 2: Run the Installer

On Windows:

  1. Open the .exe file.
  2. Accept the license agreement.
  3. Keep the default "Install Now" option selected.
  4. Wait for the installation to complete.

On Mac:

  1. Open the downloaded .pkg file.
  2. Follow the on-screen instructions. The installer handles the PATH setup for you.

On Linux (Ubuntu/Debian):
Python is usually pre-installed. To check, open your terminal and run:
python3 --version
If it's not there, you can install it with:

sudo apt-get install python3
Enter fullscreen mode Exit fullscreen mode

Step 3: Verify It Works

This is the most important step. Open your terminal (Command Prompt or PowerShell on Windows, Terminal on Mac/Linux) and type:

python --version
Enter fullscreen mode Exit fullscreen mode

You should see something like Python 3.12.x. If you see an error, you likely missed the "Add to PATH" step.

Step 4: Install an Editor (and Use It)

You can write Python in a text editor, but you'll be much happier with a proper code editor. Visual Studio Code (VS Code) is the most popular free choice.

If you don't have it, here's a quick guide: How to Install VS Code.

Once you have VS Code, install the Python extension by Microsoft. This gives you code completion, debugging, and a built-in terminal.

Step 5: Your First Script

In VS Code, create a new file called hello.py. Type:

print("Hello, world!")
Enter fullscreen mode Exit fullscreen mode

Save the file. Then, in VS Code's built-in terminal (View > Terminal), run:

python hello.py
Enter fullscreen mode Exit fullscreen mode

If you see "Hello, world!" in the terminal, you're done.

What Next?

You've installed the language and the editor. Now you need to learn the language.

Start with a structured course to avoid getting lost in random tutorials. I recommend this free, 10-lesson Python course for beginners on MAK Studio: Start the Python Course.

It covers everything from variables and loops to functions and building a calculator project. No signup required.

Top comments (0)