Python tutorials > Core Python Fundamentals > Basics and Syntax > How to install Python?

How to install Python?

Installing Python: A Comprehensive Guide

This tutorial provides step-by-step instructions on how to install Python on different operating systems (Windows, macOS, and Linux). Proper installation ensures you can run Python code and utilize its vast ecosystem of libraries and frameworks.

Checking for Existing Python Installation

Before installing Python, it's crucial to check if it's already installed on your system. This prevents conflicts and ensures you don't unintentionally overwrite an existing installation.

Windows: Open Command Prompt (cmd) or PowerShell and type python --version or py --version. If Python is installed, it will display the version number. If not, you'll see an error message.

macOS: Open Terminal and type python3 --version or python --version. macOS usually comes with a pre-installed Python 2.x version. For Python 3, use python3.

Linux: Open Terminal and type python3 --version or python --version. Similar to macOS, many Linux distributions come with Python pre-installed. Use python3 for Python 3.

Installation on Windows

Step 1: Download the Python Installer: Go to the official Python website (python.org) and navigate to the 'Downloads' section. Choose the latest stable version of Python for Windows. Download the executable installer.

Step 2: Run the Installer: Double-click the downloaded executable file to start the installation process.

Step 3: Configure Installation Settings:

  • Important: Check the box that says 'Add Python to PATH'. This ensures that you can run Python from the command line without specifying its full path.
  • Click 'Customize installation' for more granular control, or 'Install now' for a default installation.

Step 4: Optional Customization: If you chose 'Customize installation', you can select optional features like 'pip' (a package installer), 'tcl/tk' (for GUI development), and 'py launcher' (for managing multiple Python versions). Choose an installation directory or accept the default.

Step 5: Complete Installation: Click 'Install' to begin the installation process. Wait for the installation to complete.

Step 6: Verify Installation: Open a new Command Prompt or PowerShell window and type python --version or py --version. The Python version number should be displayed, confirming a successful installation.

Installation on macOS

Step 1: Download the Python Installer: Go to the official Python website (python.org) and navigate to the 'Downloads' section. Choose the latest stable version of Python for macOS. Download the macOS installer package.

Step 2: Run the Installer: Double-click the downloaded installer package to start the installation process. Follow the on-screen instructions.

Step 3: Complete Installation: The installer will guide you through the installation process. Accept the license agreement and choose an installation location.

Step 4: Verify Installation: Open Terminal and type python3 --version. The Python version number should be displayed, confirming a successful installation. Note that you usually need to use python3 to invoke the newly installed version, as macOS often has a system Python version installed.

Installation on Linux

The installation process on Linux varies depending on the distribution. Most distributions include Python by default.

Debian/Ubuntu: Open Terminal and run the following commands:

  • sudo apt update
  • sudo apt install python3 python3-pip

Fedora/CentOS/RHEL: Open Terminal and run the following commands:

  • sudo dnf update
  • sudo dnf install python3 python3-pip

Arch Linux: Open Terminal and run the following commands:

  • sudo pacman -Syu
  • sudo pacman -S python python-pip

Step 2: Verify Installation: Open Terminal and type python3 --version. The Python version number should be displayed, confirming a successful installation. Also check pip3 --version to confirm the package installer is available.

Installing pip (Python Package Installer)

pip is the package installer for Python. It allows you to easily install and manage third-party libraries and modules. While most recent Python installations include pip by default, you might need to install or upgrade it separately.

Checking if pip is installed: Open a Command Prompt/Terminal and type pip --version or pip3 --version. If pip is installed, it will display the version number.

Installing/Upgrading pip: If pip is not installed or you want to upgrade it, run the following command:

python -m ensurepip --default-pip (Windows)

python3 -m ensurepip --default-pip (macOS/Linux)

To upgrade pip:

python -m pip install --upgrade pip (Windows)

python3 -m pip install --upgrade pip (macOS/Linux)

Real-Life Use Case Section

Imagine you want to analyze data from a website. You need to install the requests library to fetch the website's content and the beautifulsoup4 library to parse the HTML. Without a proper Python installation and pip, this would be impossible. You would install them using the following commands in your terminal:

pip install requests

pip install beautifulsoup4

Best Practices

Use Virtual Environments: Always create virtual environments for your Python projects. This isolates project dependencies and prevents conflicts between different projects. Use the venv module:

python -m venv myenv (Create a virtual environment named 'myenv')

myenv\Scripts\activate (Windows)

source myenv/bin/activate (macOS/Linux)

Keep Python Updated: Regularly update your Python installation to the latest stable version to benefit from bug fixes, security patches, and new features.

Install Packages with pip: Use pip to install and manage Python packages. Avoid manually downloading and installing packages, as this can lead to dependency issues.

When to Use Them

You need to install Python whenever you want to run Python code on your machine. This includes developing Python applications, running scripts, using Python libraries, and working with Python-based tools and frameworks.

Alternatives

Anaconda: Anaconda is a Python distribution that comes with a pre-installed package manager (conda) and a large collection of data science libraries. It's a good choice for data scientists and machine learning engineers.

Miniconda: Miniconda is a minimal version of Anaconda that only includes conda and its dependencies. It's a good option if you want more control over which packages are installed.

Docker: Docker allows you to run Python in isolated containers, ensuring consistent environments across different systems. This is especially useful for deploying Python applications.

← How to evaluate expressions? How to iterate over sequences? →

FAQ

  • How do I check which version of Python is installed?

    Open a Command Prompt/Terminal and type python --version or python3 --version (depending on your system and the version you want to check). On Windows, you might also try py --version.
  • What is pip and how do I use it?

    pip is the package installer for Python. It's used to install and manage Python packages. To install a package, type pip install package_name in the Command Prompt/Terminal (or pip3 install package_name).
  • Why should I use a virtual environment?

    Virtual environments isolate project dependencies, preventing conflicts between different projects. This ensures that each project has its own set of required packages without affecting other projects or the system-wide Python installation.
  • I'm getting a 'command not found' error when I type 'python'. What should I do?

    This usually means that Python is not in your system's PATH environment variable. During installation, make sure to check the box that says 'Add Python to PATH'. If you didn't do that, you'll need to manually add the Python installation directory (e.g., C:\Python39) to your PATH environment variable in Windows system settings. On macOS/Linux, ensure your shell configuration (.bashrc, .zshrc) correctly points to the Python executable.