Installation
Choose your platform for detailed installation instructions:
Quick Install (All Platforms)
bash
# macOS and Linux
curl -fsSL https://uselovelace.com/lattice/install.sh | sh
# Windows (PowerShell)
irm https://uselovelace.com/lattice/install.ps1 | iex
Platform-Specific Guides
- macOS Installation → - Intel and Apple Silicon
- Linux Installation → - Ubuntu, Debian, Fedora, and others
- Windows Installation → - Windows 10 and later
What Gets Installed
The installation script:
- Downloads the lattice daemon binary (native Rust executable)
- Installs system service (launchd/systemd/Windows Service)
- Creates configuration directory (~/.lovelace/lattice/)
- Registers shell commands for
lattice-ctl - Sets up auto-start on boot
Verification
After installation, verify everything works:
bash
# Check version
lattice-ctl --version
# Start daemon
lattice-ctl daemon start
# Verify daemon is running
lattice-ctl ping
Expected output:
✓ Lattice daemon is running (PID: 12345)
Uptime: 2 seconds
Socket: /Users/you/.lovelace/lattice/daemon.sock
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| RAM | 2GB | 8GB+ |
| Disk Space | 200MB | 1GB+ |
| CPU | Dual-core | Quad-core+ |
| Internet | Required for setup only | Local models work offline |
Uninstalling
To uninstall lattice:
macOS/Linux
bash
# Stop the daemon first
lattice-ctl daemon stop
# Remove the installation
rm -rf ~/.lovelace/lattice/
Windows
powershell
# Stop the service
lattice-ctl daemon stop
# Remove the installation directory
Remove-Item -Path $env:APPDATA\.lovelace -Recurse -Force
Troubleshooting Installation
"Permission denied" error
bash
# macOS/Linux may need sudo for daemon operations
sudo lattice-ctl daemon start
# Or fix directory permissions
chmod 755 ~/.lovelace/lattice/
chmod 755 ~/.lovelace/
"Command not found: lattice-ctl"
bash
# Reload shell configuration
source ~/.bashrc # or ~/.zshrc for zsh
# Windows: Close and reopen PowerShell
Installation script fails
Check if curl (macOS/Linux) or PowerShell is available:
bash
# macOS/Linux
curl --version
# Windows - ensure PowerShell is available
powershell -Version
Daemon won't start
Check if the daemon is already running:
bash
# Check daemon status
lattice-ctl daemon status
# If already running, you can use it directly
lattice-ctl ping
Next Steps
After installing:
- Quickstart → - Configure a provider and run your first chat
- Manage Agents → - Create autonomous agents and manage sessions
- Advanced Configuration → - Providers, local models, P2P mesh
Need Help?
- Troubleshooting → - Common issues and solutions
- Overview → - Understanding Lattice concepts