Skip to main content

CLI Installation Guide

Install the Lovelace CLI (ada) on any platform

Recommended Installation

macOS (Homebrew)

bash
brew tap lovelace-ai/lovelace https://github.com/ReasonableTech/lovelace
brew install lovelace-cli
ada --version

Windows (Winget)

powershell
winget install ReasonableTech.LovelaceCLI
ada --version

Debian/Ubuntu (APT)

bash
# Add the Lovelace APT repository
curl -fsSL https://reasonabletech.github.io/apt/lovelace.gpg | sudo gpg --dearmor -o /usr/share/keyrings/lovelace.gpg

echo "deb [signed-by=/usr/share/keyrings/lovelace.gpg] https://reasonabletech.github.io/apt stable main" | \
  sudo tee /etc/apt/sources.list.d/lovelace.list > /dev/null

sudo apt update
sudo apt install lovelace-cli
ada --version

Universal Installer (curl / PowerShell)

macOS / Linux / WSL

bash
curl -fsSL https://d.uselovelace.com/install | sh
ada --version

Windows (PowerShell)

powershell
Invoke-WebRequest -Uri https://d.uselovelace.com/install.ps1 -UseBasicParsing | Invoke-Expression
ada --version

JS Package Managers (Installer Only)

The @lovelace-ai/cli npm package downloads the native Rust binaries during install.

bash
npm install -g @lovelace-ai/cli
# or
pnpm add -g @lovelace-ai/cli

ada --version

Manual Downloads

Download pre-built binaries directly from GitHub Releases:

Install both ada and lovelace binaries and add them to your PATH.

Verification

bash
ada --version
lovelace --version  # Alias

Updates

Homebrew

bash
brew update
brew upgrade lovelace-cli

APT

bash
sudo apt update
sudo apt upgrade lovelace-cli

Winget

powershell
winget upgrade ReasonableTech.LovelaceCLI

npm/pnpm

bash
npm update -g @lovelace-ai/cli
# or
pnpm update -g @lovelace-ai/cli