Skip to content

Install

Michael Benson edited this page Nov 3, 2026 · 6 revisions

Warning

This page is under active development. It is not ready for student or faculty use.Please check back later.


This document provides step-by-step instructions for installing the STEM Standard Operating Environment (SOE) on Windows using a terminal and Windows PowerShell* (v. 5.1), a command-line shell.

Note

* - There are currently two flavors of PowerShell.

  • Windows PowerShell comes pre-installed on Windows and is version 5.1 or earlier. This version only runs on Windows.
  • PowerShell by itself refers to version 7.0 or later and must be manually installed in Windows. This newer version can also be installed on macOS and Linux. Learn more.

Update Winget Sources

Windows Package Manager, also called WinGet, downloads and installs applications through the winget command. Its sources are software catalogs. Updating them refreshes the package information used to find your STEM tools.

Procedure. Enter the following command in the terminal and press Enter.

winget source update

Expected Output. WinGet lists the sources it updates and shows completion messages, often ending in Done. Each source should finish without an error, and the PowerShell prompt should return. Learn more.

Tip

Manually type short commands. Doing so reinforces command syntax and helps you remember them. In addition, it is often faster to type them than to copy and paste.

Install Git

Git is a version control system: it records changes to files so you can review earlier work and track a project's history. You will also use Git to download STEM course repositories, which contain activity files and their change history. Learn more.

Procedure. Click the copy icon in the upper right corner of the command block to copy the command to the clipboard. Then paste it into the terminal and press Enter to execute it.

winget install --id Git.Git -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies Git and reports a successful installation, or says it is already installed with no available update. Wait for the PowerShell prompt to return.

Tip

Copy and paste long commands. This reduces the chance of errors and saves time compared to typing them manually. Many websites and documentation provide a copy button for copying command blocks. When provided, use them to ensure you copy the entire command block correctly.

Install GitHub CLI

GitHub CLI provides the gh command for working with GitHub from your terminal. GitHub hosts repositories online. This tool lets you manage repositories, report issues, and change settings on GitHub without leaving your development environment. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

winget install --id GitHub.cli -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies GitHub CLI and reports a successful installation, or says it is already installed with no available update. The PowerShell prompt returns.

Install PowerShell 7 or later

PowerShell 7+ is a cross-platform command-line shell and a scripting language. A script is a saved set of commands that can repeat tasks, such as setting up a course repository. This step installs PowerShell 7, which provides current tools for running STEM setup and automation scripts on Windows, macOS, or Linux systems. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

winget install --id Microsoft.PowerShell -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies PowerShell and reports a successful installation, or says it is already installed with no available update. The PowerShell prompt returns.

Install Windows Terminal

Windows Terminal holds command-line sessions in tabs, much like a browser holds web pages in tabs. It lets you keep separate PowerShell sessions open for different STEM projects. This step installs or updates Terminal so it is available for later coursework. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

winget install --id Microsoft.WindowsTerminal -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies Windows Terminal and reports a successful installation, or says it is already installed with no available update. The PowerShell prompt returns.

Install the Python Install Manager

Python Install Manager installs and manages versions of Python. It provides the pymanager command, which you will use later to install the Python interpreter for this setup. Keeping the required Python version available helps you run course examples and STEM programs. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

winget install --id Python.PythonInstallManager -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies Python Install Manager and reports a successful installation, or says it is already installed with no available update. The PowerShell prompt returns.

Install Visual Studio Code

Visual Studio Code (VS Code) is a code editor, an application for writing and editing code and project documents. It brings your files, terminal, and programming tools into one window so you can work on STEM assignments in one place. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

winget install --id Microsoft.VisualStudioCode -e --source winget --accept-source-agreements --accept-package-agreements

Expected Output. WinGet identifies Visual Studio Code and reports a successful installation, or says it is already installed with no available update. The PowerShell prompt returns.

Update the System Path

The PATH environment variable is a list of folders that Windows searches to find programs named in commands. The installers have added folders for your new tools. This command refreshes PATH in your current PowerShell session using the saved system and user values, so you can run those tools by name. Learn more.

Procedure. Copy the command block into the terminal and press Enter. Include the dollar sign ($) at the start.

$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User')

Expected Output. This command normally displays no text. The PowerShell prompt returns without an error.

Verify the tools. Run the following command to check that PowerShell can find the programs you installed:

Get-Command git, gh, pwsh, pymanager, code

PowerShell should display a table with an entry for each of the five commands. The names may include endings such as .exe or .cmd. If any command is not recognized, resolve that problem before continuing.

Install the Python Interpreter

The Python interpreter is the program that reads and runs Python code. You will use it for tasks such as calculations, data analysis, and automation. The command below uses Python Install Manager to install a Python 3.12 interpreter for this setup. Learn more.

Procedure. Copy the command block into the terminal and press Enter.

pymanager install 3.12 --quiet

Expected Output. The --quiet option reduces installation messages, so you may see little or no output. Wait for the PowerShell prompt to return without an error, then check the installed interpreter with this command:

pymanager exec -V:3.12 --version

The result should begin with Python 3.12., followed by a patch number. The patch number may vary; the important part is that the interpreter reports version 3.12.

Install VS Code Extensions

Extensions are add-ons that give VS Code extra features. The extensions below provide support for Python and PowerShell, check code and spelling, keep formatting consistent, create diagrams, and preview or export Markdown documents. These features help you write and review STEM assignments. Learn more.

Procedure. Copy and run each line below in PowerShell. Wait for one command to finish before running the next.

(Invoke-RestMethod "https://raw.githubusercontent.com/GC-STEM/SOE/main/.vscode/extensions.json").recommendations | ForEach-Object { code --install-extension $_ }

Expected Output. Each command names an extension and reports that it was successfully installed or is already installed. All commands should finish without an error. If VS Code asks you to reload the window, save any open work and select Reload.

Clone this wiki locally