Windows is a first-class target for Liminal: PowerShell-friendly install, Playwright Chromium for browser tools, and Obsidian vault discovery via %APPDATA%\\Obsidian\\obsidian.json.

Step-by-step page: /liminal/guides/windows. Use case: local-first privacy.

Prerequisites

  • Node.js 20+ (LTS recommended) and Git
  • An API key (OpenRouter recommended) or a local Ollama server
  • Optional: Obsidian if you want vault memory on an existing vault

Quick install

curl -fsSL https://www.vireondynamics.com/install/install.sh | bash

If you prefer a manual clone:

git clone https://github.com/traidy2222/liminal-ai.git
cd liminal-ai
npm install
npm run build
copy .env.example .env
# Edit .env — set AGENT_API_KEY
npm run web

Open http://localhost:3001 for the web UI, or npm run tui for the terminal UI.

.env on Windows

AGENT_API_KEY=sk-or-v1-...
AGENT_API_BASE_URL=https://openrouter.ai/api/v1
AGENT_MODEL=deepseek/deepseek-v4-pro
AGENT_FAST_MODEL=deepseek/deepseek-v4-flash

# Obsidian (optional)
AGENT_VAULT_PATH=C:\Users\You\Documents\MyVault
AGENT_MEMORY_GRAPH=1

Use forward slashes or escaped backslashes in paths. For multiple Obsidian vaults, always set AGENT_VAULT_PATH — auto-discovery only picks unambiguous configs.

Where files land

PathContents
Project workspaceRepo you point the agent at (AGENT_WORKSPACE_ROOT)
.agent_sessions/JSONL traces per task
.agent_notes.jsonStructured memory
~/.liminal/memory.index.jsonEmbedding index (global)
%APPDATA%\\Obsidian\\obsidian.jsonVault discovery source

Comparison table

Browser tools on Windows

Run once per machine:

npm run browser:install

Sets up Playwright Chromium for browser_* tools. Use headed mode for debugging: AGENT_BROWSER_HEADED=1.

Common Windows issues

  • Execution policy — if scripts are blocked, set policy for CurrentUser or run via bash from Git Bash.
  • Long paths — enable Win32 long paths if deep node_modules paths fail.
  • Firewall — local web UI binds localhost; LLM calls need outbound HTTPS to your provider.

Next steps

Install