Guide · Updated 2026-06-12
Install Liminal on macOS
Install via the hosted bash script: same flow as Linux.
Prerequisites
Node.js 22+ (Homebrew: brew install node@22).
Xcode Command Line Tools for native modules (xcode-select --install).
An API key from OpenRouter, OpenAI, Anthropic, or a local Ollama endpoint.
Install
Open Terminal and run: curl -fsSL https://www.vireondynamics.com/install/install.sh | bash
The script clones liminal-ai, installs npm workspaces, and can launch the web UI on localhost:3001.
Desktop app (recommended)
Download the native Liminal desktop app from the get-started page for menu-bar access, live tool streaming, and one-click OAuth connectors.
CLI and web UIs remain available for developers who prefer terminal workflows.
First run
Set AGENT_API_KEY in `.env`, then send a small task (e.g. summarize README).
Full configuration reference: https://docs.vireondynamics.com/liminal/
FAQ
Common questions
Apple Silicon?
Yes: use the arm64 Node build from nodejs.org or Homebrew.
Does Liminal work offline?
The harness runs locally; inference needs either a local model (Ollama) or network access to your API provider.