Python Setup — Zero to Ready 🐍

🐍 Getting Started

Python Setup — Zero to Ready

By the end of this guide you'll have Python fully installed, configured, and ready to code — on any operating system.

🐍

Python Interpreter

The program that reads and runs your .py files. Without it, your code can't execute.

📦

pip — Package Manager

Installs 500,000+ libraries from PyPI: NumPy, Pandas, Flask, PyTorch — one command each.

🏝

Virtual Environments

Isolated sandboxes per project so packages never conflict. Essential for professional work.

🛠

IDE / Editor

VS Code, PyCharm, Jupyter — pick the right tool for your workflow.

⚠️

Always install Python 3.xPython 2 hit end-of-life in 2020. This guide uses Python 3.12 — the latest stable release.

Select your operating system for personalised instructions throughout:

🪟

Windows

10 or 11

🍎

macOS

Monterey or later

🐧

Linux

Ubuntu / Debian / Fedora

⬇️ Step 1

Download Python

Get the installer from the official source. Always use python.org — never unofficial mirrors.

✅

Latest Stable VersionPython 3.12.x — released October 2023. 3.12.x

1

Open python.org in your browser

Go to https://www.python.org/downloads/ — the site auto-detects Windows and shows the right button.

2

Click "Download Python 3.12.x"

The large button downloads the Windows 64-bit installer (.exe). For 32-bit systems, scroll down to "Files" and pick the x86 installer.

ℹ️

Not sure? Go to Settings → System → About. "System type" shows 64-bit or 32-bit. Almost certainly 64-bit on modern machines.

3

Wait for download (~25 MB)

File name: python-3.12.x-amd64.exe. Find it in your Downloads folder.

⚠️

Don't use the system PythonmacOS ships with Python 2.7 or 3.x for internal OS use. Always install your own Python separately.

A

Option A — Homebrew (Recommended)

Install Homebrew first if needed, then Python:

$/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

$brew install python

B

Option B — Official .pkg Installer

Go to python.org/downloads, download the macOS .pkg file, and double-click to install. Requires manual PATH config afterwards.

ℹ️

Most Linux distros already have Python 3. Check first: python3 --version

$sudo apt update && sudo apt install python3 python3-pip python3-venv -y

$sudo dnf install python3 python3-pip -y

$sudo pacman -S python python-pip

💾 Step 2

Installation

Run the installer with the right settings. One checkbox makes the difference between success and hours of frustration.

🚨

CRITICAL: Check "Add Python to PATH" before clicking InstallThis single checkbox is the most-missed step. Without it, Python won't work from the command line at all.

🪟 Python 3.12.0 (64-bit) Setup

Install Python 3.12.0 (64-bit)

Install launcher for all users (recommended)

☑ Add Python.exe to PATH CHECK THIS!

1

Double-click the downloaded .exe

python-3.12.x-amd64.exe — click "Yes" on the UAC prompt.

2

✅ CHECK "Add Python to PATH" FIRST

At the bottom of the first screen. If you miss this, Python won't be accessible from Command Prompt or PowerShell.

3

Click "Install Now"

Default installation is fine for most users. Takes ~1–2 minutes.

4

Click "Close" when done

If prompted to "Disable path length limit" — click it. Removes a Windows restriction on long file paths.

1

Using Homebrew? Already done!

brew install python handled everything. Skip to Step 3 (Verify).

2

Using .pkg installer

Double-click python-3.12.x-macos.pkg, follow the wizard, accept the license.

3

Install SSL certificates (important!)

$/Applications/Python\ 3.12/Install\ Certificates.command

✅

Already done!The package manager command from Step 1 installed Python and pip automatically. Head straight to Verify.

✅ Step 3

Verify Your Installation

Open a terminal and run these commands. If they all return output, you're good to go.

💡

Open Command Prompt or PowerShellPress Win + R → type cmd → Enter. Or search "PowerShell" in the Start menu.

💡

Open TerminalPress Cmd + Space → type "Terminal" → Enter.

💡

Open TerminalPress Ctrl + Alt + T or find Terminal in your applications.

Click a command to see expected output:

Terminal — Interactive Demo

python --version

Expected output after successful install

$ python --version

Python 3.12.4 ← you should see this (3.x.x)

$ pip --version

pip 24.0 from /usr/local/lib/python3.12/...

$ python -c "print('Hello, Python!')"

Hello, Python!

⚠️

macOS / Linux: use python3You may need python3 --version and pip3 instead of python and pip.

🚨

'python' is not recognized?PATH wasn't set during install. Jump to the Troubleshooting section for the fix.

📦 Step 4

pip & Installing Packages

pip is Python's package manager. One command installs any of 500,000+ libraries from PyPI.

Essential pip commands

# Install a package

$ pip install numpy

Successfully installed numpy-1.26.4

# Install specific version

$ pip install numpy==1.25.0

# Install multiple packages at once

$ pip install numpy pandas matplotlib

# Upgrade a package

$ pip install --upgrade numpy

# Upgrade pip itself

$ pip install --upgrade pip

# List installed packages

$ pip list

# Uninstall a package

$ pip uninstall numpy

# Save project dependencies to a file

$ pip freeze > requirements.txt

# Install from requirements file (share with team)

$ pip install -r requirements.txt

🔥 Most-Used Packages by Field

📊 Data Science

numpy — arrays & math pandas — dataframes matplotlib — plotting seaborn — statistical viz scipy — scientific computing

🤖 AI / ML

scikit-learn — classic ML torch — PyTorch deep learning tensorflow — Google DL transformers — Hugging Face openai — OpenAI API

🌐 Web Development

flask — lightweight web django — full framework fastapi — modern APIs requests — HTTP client httpx — async HTTP

⚙️ Automation

selenium — browser automation beautifulsoup4 — web scraping pillow — image processing pydantic — data validation rich — beautiful terminal output

🏝 Step 5

Virtual Environments

Isolate packages per project. Prevents version conflicts and is best practice for all Python work.

🏝

Why you NEED virtual environmentsWithout them, all projects share the same global packages. Project A needs Django 3.2, Project B needs Django 4.2 — they'll break each other. venv solves this with one command.

Complete venv workflow:

Windows — PowerShell or cmd

# 1. Create project folder

> mkdir my-project && cd my-project

# 2. Create virtual environment

> python -m venv venv

# 3. Activate it

> .\venv\Scripts\activate

(venv) C:\my-project> ← prefix shows venv is active

# 4. Install packages (only this venv)

(venv) > pip install requests numpy pandas

# 5. Freeze dependencies

(venv) > pip freeze > requirements.txt

# 6. Deactivate when done

(venv) > deactivate

macOS — Terminal

# 1. Create project folder

$ mkdir my-project && cd my-project

# 2. Create virtual environment

$ python3 -m venv venv

# 3. Activate it

$ source venv/bin/activate

(venv) my-project $ ← prefix shows venv is active

# 4. Install packages

(venv) $ pip install requests numpy pandas

# 5. Deactivate when done

(venv) $ deactivate

Linux — Terminal

# 1. Create project folder

$ mkdir my-project && cd my-project

# 2. Create virtual environment

$ python3 -m venv venv

# 3. Activate it

$ source venv/bin/activate

(venv) user@machine:~/my-project$

# 4. Install, freeze, deactivate — same as macOS

venv Alternatives

Tool	Best For	Key Feature	Install
venv Built-in	Beginners, general use	Included with Python 3.3+	—
virtualenv	More features than venv	Faster, supports old Python	pip install virtualenv
conda	Data science, Jupyter	Manages non-Python deps (CUDA, etc.)	Install Anaconda/Miniconda
poetry	Publishing packages	Modern dependency resolver	pip install poetry
uv	Speed (100x faster)	Rust-based pip+venv replacement	pip install uv

🛠 Step 6

Choose an IDE / Editor

Pick the right tool to write your Python code. Your editor is where you'll spend most of your time.

💙

VS Code

Essential VS Code Extensions for Python

🐍

Python by Microsoft

Linting, IntelliSense, debugging, formatting. The essential extension.

🎨

Pylance

Supercharged language server — faster autocomplete and type checking.

📓

Jupyter

Run Jupyter notebooks directly inside VS Code.

⚡

Ruff

Ultra-fast Python linter and formatter — replaces flake8 + black in one extension.

🔧 Troubleshooting

Common Errors & Fixes

Click any error to expand the diagnosis and exact fix. These cover 95% of setup issues.

🚨 'python' is not recognized as an internal or external command ▼

Cause: Python is not in your system PATH. The "Add to PATH" checkbox was missed during installation.

Fastest fix: Uninstall and reinstall Python — this time checking the PATH box.

Manual fix (Windows):

1

Search "Environment Variables" in Start → "Edit system environment variables"

2

Click "Environment Variables" → find "Path" in System variables → "Edit"

3

Add C:\Users\YourName\AppData\Local\Programs\Python\Python312\ and ...\Python312\Scripts\

4

Restart Command Prompt/PowerShell and try again.

🚨 pip: command not found ▼

Cause: pip not installed or not in PATH. On Linux it's a separate package.

$python -m pip install --upgrade pip

Linux: sudo apt install python3-pip

🚨 ModuleNotFoundError: No module named 'xyz' ▼

Cause: Package not installed, or installed in the wrong Python / environment.

$pip install xyz

If still fails, check you're in the right venv: which python (Mac/Linux) or where python (Windows)

🚨 PermissionError / Access denied during pip install ▼

Cause: Trying to install globally without admin rights.

Always use a virtual environment!

Or add --user flag:

$pip install xyz --user

🚨 SSL: CERTIFICATE_VERIFY_FAILED (macOS) ▼

Cause: macOS .pkg installer doesn't auto-install SSL certificates.

$/Applications/Python\ 3.12/Install\ Certificates.command

🚨 venv activation fails on Windows PowerShell ▼

Cause: PowerShell execution policy blocks scripts by default.

Run PowerShell as Administrator:

$Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Or simply use Command Prompt (cmd) instead of PowerShell.

🚨 SyntaxError / wrong Python version ▼

Cause: python on your system points to Python 2 instead of Python 3.

Use python3 and pip3 instead. Check with python3 --version.

🚀 You're Ready!

What's Next?

Python is installed and configured. Here's your checklist and learning roadmap.

✅ Final Checklist — verify everything works

✓

Python 3.12+ installed — python --version works

✓

pip works — pip --version shows output

✓

Ran python -c "print('Hello!')" successfully

✓

Created and activated a virtual environment with venv

✓

Installed a test package: pip install requests

✓

Chose and installed an IDE (VS Code or PyCharm)

🗺 Learning Roadmap — What to tackle next

WEEK 1–2

Python Basics

Variables, data types, loops, functions, conditionals, lists, dicts, sets. Resource: docs.python.org or freeCodeCamp Python course.

WEEK 3–4

OOP & Modules

Classes, inheritance, modules, packages, file I/O, exception handling, decorators.

MONTH 2

Pick a Specialisation

Data Science: NumPy → Pandas → Matplotlib → Scikit-learn
Web Dev: Flask or FastAPI → REST APIs → Databases
AI/ML: PyTorch → Neural Networks → Transformers

MONTH 3+

Build Real Projects

GitHub portfolio → open source contributions → projects that solve real problems. Learning by building is irreplaceable.

🎉

Try your first Python script right now!Open a terminal, type python to enter the REPL, and paste this:

Your first Python program

# Paste this after typing: python

>>> name = input("What's your name? ")

What's your name? Alice

>>> print(f"Hello, {name}! Welcome to Python 🐍")

Hello, Alice! Welcome to Python 🐍

>>> print(sum(range(1, 101))) # Sum 1 to 100

5050

🎓

Python is Ready to Go!

You've completed the full setup. Now go build something amazing.