# Install > Download the NeuroSquad installer for Windows, choose where to install it, and let the setup wizard get everything else ready. Source: https://docs.neurosquad.ai/en/getting-started/installation NeuroSquad comes as a ready-made installer for **Windows 10 and 11 (64-bit)**. The download is a small web installer (160 KB): it fetches the latest version (about 100 MB), checks its SHA-256 checksum and starts setup. There is nothing to build and no terminal involved. On a Mac, see [Install on macOS](https://docs.neurosquad.ai/en/getting-started/macos); a Linux version is coming later. [Go to the download page](https://neurosquad.ai/en/download/) **1. Download NeuroSquad-Installer.exe** Open the [download page](https://neurosquad.ai/en/download/) on our site and press **Download for Windows**. When you run it, it downloads the latest NeuroSquad, checks it and opens setup. **2. Run it — and get past SmartScreen** The installer isn't code-signed yet, so Windows may show a blue **Windows protected your PC** window. Click **More info**, check that the app is `NeuroSquad-Installer.exe`, then press **Run anyway**. **3. Choose where to install** The **Install location** is filled in for you: `%LOCALAPPDATA%\Programs\NeuroSquad`. Keep it, or pick another folder with **Browse…** — the line below shows how much space NeuroSquad needs (369 MB) and how much the disk has free. Leave **Desktop shortcut** on if you want a NeuroSquad icon on your desktop. The default folder installs NeuroSquad for your Windows account only, and the note at the bottom says **no administrator rights needed**. A folder such as Program Files says **needs administrator rights · Windows will ask** instead — Windows then asks for permission when you press Install. **4. Press Install** The window shows each step, how many files are unpacked and a progress bar. **Show log** opens the setup log: every file with its size and checksum, with timestamps. **Cancel** works while the files are being unpacked, and removes whatever was copied so far. **5. Launch NeuroSquad** When you see **NeuroSquad is installed**, press **Launch NeuroSquad**. From now on it's in the Start menu (and on the desktop, if you kept the shortcut). > SmartScreen shows that warning for any new app that isn't signed with a certificate yet. Only ever > download the installer from our [download page](https://neurosquad.ai/en/download/). ## Install from a terminal The same installer, unattended: for your Windows account, without administrator rights. Every way checks the download against its SHA-256 checksum before running it, and NeuroSquad keeps itself up to date afterwards whichever way you installed it. **winget** — Windows Package Manager, built into Windows 10 and 11: ```powershell winget install NeuroSquad.NeuroSquad ``` **Scoop** — adds the NeuroSquad bucket, then installs into Scoop's apps folder: ```powershell scoop bucket add neurosquad https://github.com/glmn-ai/scoop-neurosquad scoop install neurosquad ``` **PowerShell** — downloads the latest version, installs it into `%LOCALAPPDATA%\Programs\NeuroSquad` and starts NeuroSquad (Windows PowerShell 5.1 or PowerShell 7): ```powershell irm https://neurosquad.ai/install.ps1 | iex ``` ## Sign in On first launch NeuroSquad asks you to sign in to your NeuroSquad account — it's free. Your browser opens app.neurosquad.ai: sign in with a code sent to your email or with Google, press **Connect**, and the app picks it up. Until then the app shows only its sign-in screen. Step by step, and what the app sends while you're signed in: [Account & sign-in](https://docs.neurosquad.ai/en/getting-started/account). ## The setup wizard Once you're signed in, NeuroSquad checks what your computer already has and offers to install what is missing. Nothing changes until you press a button, and every step can be skipped — the one exception is Node.js (below). **1. Agent CLI** The AI agent your cards will run. If you already have one, the wizard says so. If not, pick Claude Code, Codex CLI, OpenCode or Kilo Code and press **Install it for me** — the wizard installs it with npm and shows exactly which command runs. No npm yet? The agent CLIs need it, so the wizard installs Node.js LTS by itself: the official archive from nodejs.org, checked against its published SHA-256, for your account only — no administrator rights. On Windows the installer already does this at install time when Node.js is missing; a Node.js you already have is never touched. **2. Terminal & Git** Git for Windows brings Git Bash, which terminal cards and isolated worktrees use. The wizard installs it with `winget` — and always asks first. **3. Dictation** The speech model for voice input isn't part of the installer — it's a separate download. Pick a model and press **Download**, or skip the step: dictation is optional and nothing else depends on it. You can download it later in **Settings → Dictation**; until then the status bar says **Dictation: download the model**. See [Speech models](https://docs.neurosquad.ai/en/dictation/models). **4. Ready** Press **Start working**. You can reopen the same steps any time in **Settings → Setup**. > You still sign in to each agent the usual way — run it once in its card and follow its own login > prompt. NeuroSquad never asks for your keys. ## Updating NeuroSquad updates itself. To update by hand, run `NeuroSquad-Installer.exe` from the [download page](https://neurosquad.ai/en/download/) again — it always fetches the newest version. Setup finds the installed version on its own: the location points at the existing install folder, the button reads **Update**, and a note says your workspaces, agents and settings are kept — they live in `%APPDATA%\NeuroSquad`, not in the app's own folder. If NeuroSquad is still running, the installer shows **NeuroSquad is still running** with every process that keeps its files busy — the app itself and the terminals of its cards — by name and PID. Close NeuroSquad yourself and press **Check again**, or press **End them and continue** (terminals open in NeuroSquad cards will stop). The new version is unpacked next to the old one and swapped in only once it is complete. If the update fails or you cancel it, the version you had stays untouched. ## Uninstalling Open **Windows Settings → Apps**, find **NeuroSquad** and choose **Uninstall** (or run `Uninstall NeuroSquad.exe` in the install folder). It removes exactly the files it installed, the shortcuts and the Apps entry. Files you put into the install folder yourself stay. Your data stays too, unless you turn on **Also delete my NeuroSquad data** (off by default). That deletes `%APPDATA%\NeuroSquad`: the workspace list, agents, settings, dictation models and the agents' isolated worktrees — uncommitted work in those worktrees is lost. Your project folders are never touched. See [Where your data lives](https://docs.neurosquad.ai/en/help/data). ## Unattended install For IT admins and scripts, the installer runs without a window. The full installer of the newest release is at `https://neurosquad.ai/downloads/NeuroSquad-Setup.exe`; the web installer passes the same options on to it. ```text NeuroSquad-Setup.exe --silent [--dir ] [--no-desktop] [--launch] [--close-app] ``` - `--dir` — install location (default: `%LOCALAPPDATA%\Programs\NeuroSquad`, or the existing install) - `--no-desktop` — no desktop shortcut - `--launch` — start NeuroSquad when done - `--close-app` — end running NeuroSquad processes instead of failing Exit codes: `0` installed, `1` failed, `2` files in use (NeuroSquad is running and `--close-app` wasn't given). To uninstall silently: ```text "Uninstall NeuroSquad.exe" --silent [--delete-data] ``` ## If something goes wrong The failure page says what happened in plain words, shows the details and the log, and offers **Try again**. If the installer fails before replacing anything, your previous version still works. The installer keeps a full log of every run in `%TEMP%\NeuroSquad-Setup-.log`, and a copy of it as `install.log` in the install folder. Press **Copy log** or **Open log file** in the log panel, and attach the log when you report a problem. ## Next - **[Your first workspace](https://docs.neurosquad.ai/en/getting-started/first-workspace)**: Point NeuroSquad at a project folder — or explore the demo.