Skip to content

Soul-driven AI agent with permission-hardened tools, token budgets, and multi-channel access. Runs 24/7 from CLI, Telegram or More.

2.7 KB
Raw Blame
---
id: windows
title: Windows
sidebar_label: Windows
---

Mercury runs natively on Windows 10 (build 1809+) and Windows 11, on **x64**. Native arm64 and 32-bit Windows binaries are not published. On Windows on ARM, consider WSL or the npm route with a compatible Node.js 22+ build.

## Quickest install (recommended)

Open Windows PowerShell 5.1 or PowerShell 7 and run:

```powershell
irm https://mercuryagent.sh/install.ps1 | iex
```

This downloads `mercury-win-x64.exe`, verifies its SHA-256, installs it to `%USERPROFILE%\.mercury\bin\mercury.exe`, and prepends that directory to your **user** `PATH`. No admin required.

After install, **open a new terminal window** and run:

```powershell
mercury --version
```

:::tip[Execution policy]

If PowerShell blocks the script, allow user scripts for the current session:

```powershell
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
irm https://mercuryagent.sh/install.ps1 | iex
```

:::

## Via npm (if you already have Node)

```powershell
npm i -g @cosmicstack/mercury-agent
mercury
```

Requires **Node.js 22+** (since 1.3.1). Install from [nodejs.org](https://nodejs.org) or via [`winget install OpenJS.NodeJS.LTS`](https://winget.run/pkg/OpenJS/NodeJS.LTS).

## Pinning a version

```powershell
$env:MERCURY_VERSION = '1.1.9'
irm https://mercuryagent.sh/install.ps1 | iex
```

## Custom install location

```powershell
$env:MERCURY_INSTALL = 'C:\Tools\mercury'
$env:MERCURY_NO_PATH = '1'
irm https://mercuryagent.sh/install.ps1 | iex
```

Then add `C:\Tools\mercury\bin` to your `PATH` manually via **System Properties → Environment Variables**.

## Windows Terminal recommended

Mercury's TUI uses Unicode, true color, and ANSI escapes. For best results, use **Windows Terminal** (default on Windows 11, [free from the Store](https://aka.ms/terminal) on Windows 10). The legacy `cmd.exe` window may render box-drawing characters incorrectly.

## WSL alternative

If you prefer a Linux environment, install Mercury inside WSL2:

```bash
wsl --install -d Ubuntu
# inside WSL:
curl -fsSL https://mercuryagent.sh/install.sh | sh
```

Follow the [Linux guide](./linux.mdx) from there.

## SmartScreen / antivirus

The `.exe` is unsigned today. SmartScreen may show "Windows protected your PC" on first run — click **More info → Run anyway**. A code-signed build is on the roadmap.

## Uninstall

```powershell
Remove-Item -Recurse -Force $env:USERPROFILE\.mercury
```

Then remove the entry from your user `PATH` (System Properties → Environment Variables).

For npm installs:

```powershell
npm uninstall -g @cosmicstack/mercury-agent
```

## Next steps

- [Setup](../setup)
- [Daemon Mode → System Service](../../daemon-mode/system-service) for running Mercury as a Windows service