Guide · Updated 2026-06-12
Install Liminal on Linux
Bash installer for most glibc-based distributions.
Prerequisites
Node.js 22+ on PATH (nodesource, nvm, fnm, or distro packages).
git and build-essential (Debian/Ubuntu) or equivalent for native npm modules.
An OpenAI-compatible API key or local Ollama server.
Install
Run: curl -fsSL https://www.vireondynamics.com/install/install.sh | bash
Works on Ubuntu, Debian, Fedora, Arch, and most glibc-based distros. For musl/Alpine, install Node 22 manually first.
Run the agent
npm run web: browser UI on port 3001.
npm run tui: terminal UI for keyboard-first workflows.
Point AGENT_WORKSPACE_ROOT at your repo for file and git tools.
Headless / server use
Liminal runs fine on a VPS or dev box over SSH. Use approval gates for destructive shell tools.
Pair with OpenRouter or a local GPU box running Ollama for fully self-hosted inference.
FAQ
Common questions
WSL on Windows?
Yes: install inside WSL2 with Node 22+, or use the native Windows desktop app for a simpler path.
Docker?
See the Docker guide for container patterns. The hosted bash installer is still the fastest path on bare metal.