WSL2 Install

Locus on Windows installs two ways: WSL2 (this page — the recommended path; identical to native Linux) or native Windows (advanced) (Phase-1; PowerShell installer, no WSL2 / no Docker). Pick WSL2 for the smoothest experience.

One-time WSL setup

In an admin PowerShell:

wsl --install

Then open the Ubuntu (or Debian) shell that gets installed.

Install Locus

curl -fsSL https://aryanjsx.github.io/Locus/install.sh | bash

About 3 minutes. Type locus to start.

WSL-specific notes

• The installer detects WSL via /proc/sys/kernel/osrelease and uses nohup ollama serve & instead of systemd to start the Ollama daemon (WSL2 doesn't ship systemd by default).
• The first time you run locus, the WSL kernel may show a "process running in background" notification — that's the bg-orchestrator detaching. It's expected.
• Models are stored in WSL's filesystem (~/.locus/), not your Windows drive. To free up space later: locus-uninstall removes everything.

See also

• Full installer reference