Docs

Windows + WSL

Windows pipeline quickstart.

Configure WSL2 so Helix Studio CLI + SDK run with the same determinism and GPU awareness as our Linux builds.

Install prerequisites

  • Update Windows 11/10 to the latest build and enable the Hyper-V and Virtual Machine Platform features.
  • Run `wsl --install --distribution Ubuntu-22.04` from PowerShell (admin).

Provision Helix dependencies

  • Inside WSL: `sudo apt-get update && sudo apt-get install build-essential git curl`.
  • Install the Helix CLI tarball we provide during onboarding and run `helix-cli doctor`.

GPU acceleration (optional)

  • Install the latest NVIDIA drivers with CUDA for Windows and enable WSL GPU passthrough.
  • Inside WSL: `sudo apt-get install nvidia-cuda-toolkit` then `nvidia-smi` to confirm visibility.

Verify connectivity

  • Run `helix-cli login --offline` if your environment is air-gapped, otherwise standard login to sync models.
  • Execute the checksum + SBOM commands listed on /downloads#verification to confirm artifact integrity.