Clear, practical technology insights
Install and Run PythonLesson 1 of 32

Install Python 3 on Windows, macOS, and Linux

Explain the purpose, important state, and technical decisions behind Install and Run Python before implementing it. Start with a mental model, then connect each part to an observable program, browser, database, framework, operating-system, or model behavior.

25 min Foundation Install and Run PythonReviewed 2026-08-07
Learning objectives

What you will learn

  • Explain the purpose, important state, and technical decisions behind Install and Run Python before implementing it.
  • Produce or inspect an annotated concept model and state/evidence trace for Install and Run Python.
  • Verify the result with Python and pip version output, the active virtual environment, and successful script output.
Before you start

What you need

  • Install Python 3 on Windows, macOS, or Linux and reopen the terminal after installation.
  • Run python --version, python3 --version, and py --version as appropriate to identify the available command.
  • Check pip through the interpreter, for example python -m pip --version or python3 -m pip --version.

Build the mental model

Install and Run Python focuses on this learner need: Install a supported Python 3 release, choose the correct command for the operating system, verify Python and pip, create a virtual environment, run a script, and fix PATH or interpreter problems. Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful.

Track the changing state and identify the evidence that makes that state observable.

Identify the parts and boundaries

In Install and Run Python, use the official Python installer or an operating-system package method appropriate to Windows, macOS, or Linux. Know why Windows may use py or python while macOS and Linux commonly use python3. Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful.

  1. 1

    Use the official Python installer or an operating-system package method appropriate to Windows, macOS, or Linux.

  2. 2

    Know why Windows may use py or python while macOS and Linux commonly use python3.

  3. 3

    Verify the interpreter with python --version, python3 --version, or py --version before installing packages.

  4. 4

    Create project-specific environments with python -m venv .venv so dependencies do not leak between projects.

Trace one concrete case

Choose one realistic input for Install and Run Python and trace it using this path lens: Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful. Predict the result before running the example, then compare prediction with evidence.

If the prediction fails, identify the assumption before changing the implementation.

Technical exampletext
INSTALL AND RUN PYTHON
======================
1. Use the official Python installer or an operating-system package method appropriate to Windows, macOS, or Linux.
2. Know why Windows may use py or python while macOS and Linux commonly use python3.
3. Verify the interpreter with python --version, python3 --version, or py --version before installing packages.
4. Create project-specific environments with python -m venv .venv so dependencies do not leak between projects.
Evidence: Python and pip version output, the active virtual environment, and successful script output
Run or inspect
Read the concept map, predict one concrete result, then compare that prediction with the module example or native tool.
Expected evidence
A module-specific concept trace connecting core decisions to observable evidence.
Practice workspace
practice/\n├── README.md\n├── install-and-run-python-concept-map.txt\n└── evidence/\n    └── expected-result.txt
Challenge

Apply Install and Run Python

Explain the purpose, important state, and technical decisions behind Install and Run Python before implementing it.

  • Use the lesson-specific technical example as a reference, not a copy.
  • Change one condition that matters to Install and Run Python.
  • Verify the result with Python and pip version output, the active virtual environment, and successful script output.

Compare a nearby alternative

For Install and Run Python, compare the shown mechanism with a nearby alternative. Use this technical point—Verify the interpreter with python --version, python3 --version, or py --version before installing packages.—inside this path context: Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful.

State the tradeoff in your own words.

Explain it back with evidence

Summarize Install and Run Python without reading the example. Explain the input or state, operation or decision, and result through this implementation lens: Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful.

For Install and Run Python, use this evidence standard: Python and pip version output, the active virtual environment, and successful script output. Interpret the evidence through this path context: Use Python 3 runtime behavior, Python objects and collections, exceptions, modules, virtual environments, files, tests, and CPython-visible execution details where useful.

Hands-on practice

Practice Install and Run Python

Create a one-page explanation of Install and Run Python using one diagram or state trace, one concrete example, and one observation that proves the model.

  1. 1

    Write the expected result before starting.

  2. 2

    Create a one-page explanation of Install and Run Python using one diagram or state trace, one concrete example, and one observation that proves the model.

  3. 3

    Record Python and pip version output, the active virtual environment, and successful script output and explain whether it matches the expectation.

Interactive practice

Practice what you learned

Exercises are optional for lesson completion and contribute to a separate Practice Mastery score.

Practice Mastery0%
Exercise A · Core Check40% base masterypython

Core Check: Install Python 3 on Windows, macOS, and Linux

Complete a focused exercise for “Install Python 3 on Windows, macOS, and Linux”. Your task is to Install a supported Python 3 release, choose the correct command for the operating system, verify Python and pip, create a virtual environment, run a script, and fix PATH or interpreter problems. Use one concrete example and show evidence that the result is correct.

Verification target: a runnable Python project with an isolated virtual environment

Not completed

    Exercise B · Mini Challenge60% base masterypython

    Mini Challenge: Install Python 3 on Windows, macOS, and Linux

    Extend “Install Python 3 on Windows, macOS, and Linux” into a boundary or failure scenario. Start from this lesson task: Install a supported Python 3 release, choose the correct command for the operating system, verify Python and pip, create a virtual environment, run a script, and fix PATH or interpreter problems. Change one condition that matters, predict the outcome first, then show evidence that confirms or disproves the prediction.

    Verification target: a runnable Python project with an isolated virtual environment

    Not completed

      Common mistakes to avoid

      • If “python is not recognized” appears on Windows, try py --version and check whether Python was added to PATH.
      • Use where python or where py on Windows, and command -v python3 or which python3 on macOS/Linux, to find the executable being used.
      • If pip installs into a different interpreter, run it as python -m pip or python3 -m pip.
      • If a newly installed command is missing, close and reopen the terminal so it reloads environment variables.
      Lesson recap

      Key takeaways

      • Explain the purpose, important state, and technical decisions behind Install and Run Python before implementing it.
      • Keep the exercise small enough to explain the important state and decision.
      • Use Python and pip version output, the active virtual environment, and successful script output rather than successful command completion alone.

      Frequently asked questions

      What should I be able to do before moving on?

      You should be able to explain the purpose of Install and Run Python, build a small example without copying the lesson line by line, and diagnose a basic failure using the relevant tool or error output.

      How much should I build for practice?

      Keep the exercise small enough that you can explain every important input, state change, and output. Add complexity only after the core behavior is reliable.

      Evidence and updates

      Sources and further reading

      1. Using Python and platform setupPython Software Foundation
      2. venv — Creation of virtual environmentsPython Software Foundation
      3. Python downloadsPython Software Foundation
      Finish this lesson

      Ready to continue?

      Mark the lesson complete so your Learning Path progress stays current on this device.