Install
-
Enable Hyper-V (see below) and restart.
-
Download the installer (NSIS
.exe) from GitHub Releases and run it. -
Install Moonlight (see below).
-
Open GpuVM. It opens without administrator rights.
What the installer does
Section titled “What the installer does”- Installs GpuVM for the whole machine in Program Files, with its own PowerShell 7, the PowerShell module, the profiles, the guest scripts, the
unattend.xmltemplate and the streaming component list inside. - Registers the GpuVM service (
gpuvm-host.exe), which does the Hyper-V work for the app. By default it starts when the app opens and stops when it quits (see Settings). Uninstalling removes it. - The data that changes (labs and downloaded installers) goes to
%ProgramData%\GpuVM, which is also restricted to administrators. - The installer is in Spanish. The app follows Windows’ display language (Spanish when Windows is in Spanish, English otherwise); change it in Settings → Appearance → Language.
Enable Hyper-V
Section titled “Enable Hyper-V”Once, in PowerShell as administrator, then restart:
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Hyper-V-AllIf virtualization is off in the BIOS/UEFI, turn on Intel VT-x or AMD-V there first.
Install Moonlight
Section titled “Install Moonlight”Moonlight shows the VM on your desktop. Download it from moonlight-stream.org, or from the repository run:
./gpuvm.ps1 client-installIt installs Moonlight with winget (MoonlightGameStreamingProject.Moonlight). winget may ask you to accept its terms the first time.
From the repository
Section titled “From the repository”Without the installer, everything uses the repository folder (CLI or development mode).
# CLI, from PowerShell 7 as administrator./gpuvm.ps1 check -Profile max-performance
# Build the installer (it ends up in app/src-tauri/target/release/bundle/nsis/)npm --prefix app run tauri build
# Design the UI without Hyper-V (sample data; ?mock=empty, ?mock=noadmin)npm --prefix app run dev
# Tests (no administrator needed)Invoke-Pester ./tests