pythoninstallationbeginnerstutorialwindowsmacoslinux

The Complete Guide to Installing Python on Any Operating System

A comprehensive step-by-step guide to installing Python on Windows, macOS, and Linux, including troubleshooting tips and best practices for different versions.

📅 August 10, 2025 · ⏱️ 8 min read · ✍️ Victor Muthomi

The Complete Guide to Installing Python on Any Operating System

Python has become one of the most popular programming languages in the world, powering everything from web applications to data science projects and artificial intelligence. If you’re looking to start your Python journey, the first step is installing it on your computer. This comprehensive guide will walk you through the installation process on all major operating systems: Windows, macOS, and Linux.

Table of Contents

  1. Before You Begin
  2. Installing Python on Windows
  3. Installing Python on macOS
  4. Installing Python on Linux
  5. Verifying Your Installation
  6. Setting Up a Virtual Environment
  7. Troubleshooting Common Issues
  8. Next Steps

Before You Begin

Before installing Python, here are a few things to consider:

  • Python Version: As of 2025, Python 3.12 is the latest stable release. I recommend installing Python 3.11 or later, as older versions may lack important features and security updates.
  • System Requirements: Python works on almost any modern computer. For basic usage, you’ll need:
    • At least 100 MB of disk space
    • 512 MB RAM (though more is always better)
    • A 64-bit operating system (recommended for better performance and compatibility)

Now, let’s dive into the installation process for each operating system.

Installing Python on Windows

  1. Download the installer:

    • Visit the official Python website
    • Click the “Download Python 3.x.x” button (where x.x is the latest version)
    • The website should automatically detect that you’re using Windows

  2. Run the installer:

    • Once downloaded, run the installer file (e.g., python-3.8.0-amd64.exe)
    • IMPORTANT: Check the box that says “Add Python to PATH” before clicking “Install Now” Add Python to PATH checkbox
    • Alternatively, you can choose “Customize installation” if you want to change the installation location or select specific features

  3. Verify the installation (see the Verification section below)

Method 2: Microsoft Store (Simple but Limited)

Windows 10/11 users have an alternative option:

  1. Open the Microsoft Store
  2. Search for “Python”
  3. Select the version you want to install (e.g., “Python 3.8”)
  4. Click “Get” or “Install”

Note: The Microsoft Store version has some limitations with system-wide access, but it’s adequate for beginners and doesn’t require administrator privileges.

Method 3: Using Windows Package Manager (winget)

If you prefer command-line installations:

  1. Open Command Prompt or PowerShell
  2. Run the following command: 
    winget install Python.Python

Installing Python on macOS

macOS comes with Python pre-installed, but it’s usually an older version. Here’s how to install the latest version:

Method 1: Official Installer

  1. Download the installer:

    • Visit the official Python website
    • Click the “Download Python 3.x.x” button
    • The website should automatically detect that you’re using macOS

  2. Run the installer:

    • Open the downloaded .pkg file
    • Follow the installation wizard
    • The installer will automatically add Python to your PATH

If you’re a developer, you likely already have Homebrew installed. If not, here’s how to get it:

  1. Install Homebrew (if you don’t have it already):

    • Open Terminal
    • Run the following command: 
      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

  2. Install Python using Homebrew:

    • Run the following command in Terminal: 
      brew install python

  3. Verify the installation (see Verification section)

Method 3: Using Conda (For Data Science)

If you’re planning to use Python primarily for data science:

  1. Download and install Miniconda or Anaconda
  2. Follow the installation wizard
  3. Open Terminal and verify the installation with conda --version

Installing Python on Linux

For most Linux Distributions Python is pre-installed you may check it via:

python3 --version

If the output is something like Python 3.x.x then Python is installed otherwise proceed to install.

The installation process varies slightly depending on your Linux distribution:

Ubuntu/Debian:

  1. Update your system:

    sudo apt update
sudo apt upgrade

  2. Install prerequisites:

    sudo apt install software-properties-common

  3. Add the deadsnakes PPA (for newer Python versions):

    sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update

  4. Install Python:

    sudo apt install python3.12 python3.12-venv python3.12-dev

  5. Install pip (Python’s package manager):

    sudo apt install python3-pip

Fedora:

  1. Update your system:

    sudo dnf update

  2. Install Python:

    sudo dnf install python3

  3. Install pip:

    sudo dnf install python3-pip

Arch Linux:

  1. Update your system:

    sudo pacman -Syu

  2. Install Python:

    sudo pacman -S python python-pip

CentOS/RHEL:

  1. Update your system:

    sudo yum update

  2. Install development tools:

    sudo yum groupinstall "Development Tools"

  3. Install Python:

    sudo yum install python3

  4. Install pip:

    sudo yum install python3-pip

Verifying Your Installation

After installing Python, it’s important to verify that it was installed correctly:

  1. Open a terminal or command prompt

  2. Check the Python version:

    python --version
# or
python3 --version

    This should display the version number you just installed.

  3. Test running Python:

    • Enter the Python interactive shell: 
      python
# or
python3
    • You should see the Python prompt (>>>)
    • Try a simple command: 
      print("Hello, Python!")
    • Exit the shell: 
      exit()

  4. Verify pip installation:

    pip --version
# or
pip3 --version

Setting Up a Virtual Environment

A virtual environment allows you to isolate project dependencies from the system-wide Python installation. This prevents version conflicts between projects, keeps your system clean, and ensures that each project runs with the exact libraries it needs. It also makes projects more portable and reproducible, since you can share the environment setup through a requirements.txt file.

Install venv Module.

On some systems, you may need to install the venv module separately.

  • Ubuntu/Debian:

    sudo apt install python3-venv

  • Windows/Mac:
    Usually included with Python installation.

Creating a Virtual Environment

Windows:

# Navigate to your project folder
cd my_project

# Create a virtual environment
python -m venv venv

# Activate the virtual environment
venv\Scripts\activate

Here, the second venv is the name of the virtual environment folder. You can use any name.

macOS/Linux:

# Navigate to your project folder
cd my_project

# Create a virtual environment
python3 -m venv venv

# Activate the virtual environment
source venv/bin/activate

Using the Virtual Environment

Once activated, you should see (venv) prefix in your terminal prompt or command prompt. Then proceed:

  1. Install packages:
pip install package_name

To save installed dependencies:

pip freeze > requirements.txt

To install from requirements.txt:

pip install -r requirements.txt

  1. Run Python scripts:

    python script.py

  2. Deactivate the environment when you’re done:

    deactivate

Troubleshooting Common Issues

Python Not Found After Installation

Windows:

  • Make sure you checked “Add Python to PATH” during installation
  • If you didn’t, you can:
    • Reinstall Python with this option checked, or
    • Manually add Python to your PATH environment variable

macOS/Linux:

  • Try using python3 instead of python
  • Check if Python is in your PATH: 
    which python3

Pip Not Working

  • Try using pip3 instead of pip
  • If pip isn’t installed:
    • Windows: python -m ensurepip --upgrade
    • macOS/Linux: python3 -m ensurepip --upgrade

Permission Errors

Windows:

  • Run Command Prompt or PowerShell as Administrator

macOS/Linux:

  • Use sudo for system-wide installations
  • Alternatively, set up a virtual environment or use the --user flag: 
    pip install --user package_name

Multiple Python Versions Conflict

  • Use virtual environments to manage different Python versions
  • Use version-specific commands (python3.11, python3.12, etc.)
  • On macOS/Linux, you can use tools like pyenv to manage multiple Python versions

Next Steps

Now that you have Python installed, here are some suggestions for what to do next:

  1. Set up a code editor:

  2. Learn Python basics:

  3. Join the community:

Remember, the best way to learn programming is by doing. Start with small projects, learn from your mistakes, and gradually tackle more complex challenges. Happy coding!

← Back to Blog