Skip to content

Install

Michael Benson edited this page Nov 10, 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 or updating the STEM Standard Operating Environment (SOE) using a command-line terminal, Windows PowerShell, and, Windows Package Manager. Follow these instructions carefully and in order to ensure a successful setup.

  1. Open a Terminal
  2. Update WinGet sources
  3. Install Git for Windows
  4. Install GitHub CLI
  5. Install PowerShell 7
  6. Install Python Install Manager
  7. Install Visual Studio Code
  8. Refresh Terminal Path
  9. Install Python Interpreter
  10. Install VS Code Extensions
  11. Next Steps

Open a Terminal

Windows Terminal is an application that provides a window for entering text commands. PowerShell is a shell—a program that reads and runs those commands. Working this way is called using the command line. Learn more.

If this is your first time using a terminal, follow this guide in order. It walks you through each step and provides the exact commands to enter. For more background, you can review Terminal Basics at any time.

If you have installed the SOE on another computer or are comfortable installing applications from the command line, Quick Setup provides an all-at-once installation option.

Procedure.

  1. Open the Power User menu by pressing Windows key (⊞) + X or right-clicking Start (⊞).
  2. Select Terminal or PowerShell, depending on which is available on your system.
  3. Check the command prompt, the line where you enter commands. If it does not start with PS, type powershell and press Enter.

Expected Output. You should see a PowerShell command prompt similar to PS C:\Users\penmen>. In this example, penmen is the Windows username. Your prompt may show your username. Once you have a prompt that starts with PS, you are ready to type or paste the commands from this guide. The prompt path is not critical; it simply shows the current working directory.

Update WinGet sources

WinGet sources provide catalogs of available applications and fonts for installation or upgrade through WinGet. The three default source names are msstore, winget,and winget-font. Learn more.

Procedure. Type the command into the terminal and press Enter to run the command.

winget source update

Expected Output. WinGet lists the sources it updates and shows completion messages, often ending in Done. Each source finishes without an error, and the PowerShell prompt returns. 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 for Windows

Git for Windows provides Git, Git Bash, and other supporting tools for Windows. Learn more.

Git is a version control system that records changes to files so you can review earlier work, track changes, and restore previous versions, if needed. Learn more.

Git Bash provides GNU Bash (Bourne Again SHell) emulation environment for Windows, allowing you to run bash commands and other Unix-like utilities from the terminal, similar to a Linux or macOS environment. Bash is the primary command-line shell used in the STEM Standard Operating Environment (SOE). Learn more.

Procedure. Click the copy icon (two squares overlapping) on the right side of the command block to copy the entire command to your clipboard. Then paste it into your terminal and press Enter to run the command.

winget install --id Git.Git -e --source winget --accept-source-agreements --accept-package-agreements
if ((($gitUserPath = [Environment]::GetEnvironmentVariable('Path', 'User')) -split ';') -notcontains 'C:\Program Files\Git') { [Environment]::SetEnvironmentVariable('Path', ($gitUserPath + ';C:\Program Files\Git').Trim(';'), 'User') }

If a User Account Control (UAC) prompt appears, click Yes to allow the installation to proceed. Learn more.

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

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-line interface (CLI) for working with GitHub from your terminal. This CLI tool lets you manage repositories, report issues, and change settings on GitHub without leaving your terminal. 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

PowerShell is a command-line shell and scripting language. A script is a saved set of commands that automates tasks, such as setting up a course repository. Learn more.

Windows includes Windows PowerShell 5.1 (powershell.exe), which runs only on Windows. PowerShell 7+ (pwsh.exe) is the newer edition for Windows, macOS, and Linux. We install PowerShell 7 to provide a consistent environment for the STEM setup and automation scripts used in this course. It installs alongside Windows PowerShell 5.1. 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 Python Install Manager

Python Install Manager (PIM) installs and manages Python interpreters—the software that runs Python code. Its pymanager command lets you install, list, update, and remove Python versions. As you progress to more advanced courses or projects, you may need more than one Python version. PIM helps you manage those versions when the need arises. 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 the most popular extensible code editor. A code editor is an application for writing and editing code and related documents. Extensible means it can be enhanced with extensions to support additional languages, tools, and workflows, allowing you to complete all your development tasks 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.

Refresh Terminal Path

When you type a command such as git, PowerShell uses PATH to find the program. PATH is a Windows setting that lists the folders to search.

The installers updated Windows’ saved PATH, but your terminal may still be using an older copy. This step refreshes it and checks your installation progress before you continue. Learn more.

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

$env:Path = [Environment]::GetEnvironmentVariable('Path','Machine') + ';' + [Environment]::GetEnvironmentVariable('Path','User'); Get-Command git, git-bash, gh, pwsh, pymanager, code

Expected Output. PowerShell displays a table listing all six commands without errors, as in the example below. The example uses penmen as the Windows user folder name. Your output will show current version numbers or 0.0.0.0. In addition, your source paths may vary. Your output will also show your own user folder name instead of penmen. This is normal and expected. The key indicator of success is that all six commands appear without errors.

CommandType Name           Version   Source
----------- ----           -------   ------
Application git.exe        2.56.0.4  C:\Program Files\Git\cmd\git.exe
Application git-bash.exe   2.56.0.4  C:\Program Files\Git\git-bash.exe
Application gh.exe         0.0.0.0   C:\Program Files\GitHub CLI\gh.exe
Application pwsh.exe       0.0.0.0   C:\Users\penmen\AppData\Local\Microsoft\...
Application pymanager.exe  0.0.0.0   C:\Users\penmen\AppData\Local\Microsoft\...
Application code.cmd       0.0.0.0   C:\Users\penmen\AppData\Local\Programs\...

If a command is not recognized, repeat that tool’s installation step. Then run this command block again. Do not continue until all six commands appear without errors.


Install 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 the SOE Python version. Learn more.

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

pymanager exec -V:3.12 --version

Expected Output. Look for a line beginning with Python 3.12, followed by a patch number. The patch number will vary; the important part is that the interpreter reports version 3.12. The PowerShell prompt returns.

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 the command block into PowerShell and press Enter. Wait for all extensions to finish and the PowerShell prompt to return.

& { $soeNodeOptions = $env:NODE_OPTIONS; try { $env:NODE_OPTIONS = "$soeNodeOptions --disable-warning=DEP0169".Trim(); (Invoke-RestMethod "https://raw.githubusercontent.com/GC-STEM/SOE/main/.vscode/extensions.json").recommendations | ForEach-Object { code --install-extension $_ --force } } finally { $env:NODE_OPTIONS = $soeNodeOptions } }

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.

Next Steps

Congratulations on completing the step-by-step installation of the STEM Standard Operating Environment (SOE) on Windows. If you need to re-install the SOE on the same machine or a different one, consider following the Quick Setup guide.

You have not completed the SOE setup process yet. The next setup phase is to Configure the SOE with your personal information.