Windows

Most Windows users should use the source install path below. It is the recommended Windows path today, gives you useful terminal logs, and avoids the unsigned beta installer.

The Windows .exe build exists for installer testing, but it is unsigned and may be blocked by SmartScreen. Use it only if you are explicitly testing packaging; see Experimental installer.

Requirements

Install these first:

Node.js 22+
Git for Windows
pnpm 10+
an agent CLI, usually claude or codex

Install pnpm with:

npm install -g pnpm

Or use Corepack if you already prefer it:

corepack enable
corepack prepare pnpm@latest --activate

Clone and install

Open PowerShell, then run:

git clone https://github.com/TraderAlice/OpenAlice.git
cd OpenAlice
pnpm install

Run OpenAlice

pnpm dev

The dev orchestrator prints the URLs it picked. Open the UI URL, usually:

http://localhost:5173

Trust the URL printed by the terminal if the port auto-bumps.

OpenAlice does not run the model loop inside its own backend. It starts native agent CLIs inside workspaces.

For Claude Code:

claude

Complete the login flow once. If you use Codex:

codex login

You can also add API-key credentials later in Settings -> AI Provider.

Do you need WSL or Git Bash?

Usually, no.

Built-in workspace templates bootstrap on OpenAlice's bundled Node and bundled git. They do not need bash, WSL, or system git at runtime.

You only need Git Bash or WSL2 when a third-party workspace template still ships a bootstrap.sh and expects a POSIX shell.

Experimental installer

The Windows .exe is available for packaging smoke tests:

Download the experimental Windows .exe

It is unsigned, so SmartScreen may block it. If you are trying OpenAlice rather than testing the installer itself, use the source path above.

Troubleshooting

PowerShell cannot run pnpm — Check your execution policy or use a normal terminal profile that can run global npm binaries.

A port is already in use — pnpm dev probes and auto-bumps ports. Open the URL it prints.

SmartScreen blocks the .exe — Use the source path above. The .exe is not the recommended Windows path yet.

Agent authentication fails — Run claude or codex login directly in the same Windows user account, complete login, then restart pnpm dev.

Next Steps

Quick Start - Run a real workspace-backed task.
Source & Dev - Learn the dev process, ports, tests, and logs.
AI Providers - Use API keys instead of CLI subscription login.
Workspace Templates - Understand why built-in templates work without bash.

Search Documentation