Skip to main content

​
Install with one command

curl -fsSL https://get.lukan.ai/install.sh | bash
The installer:
  • Detects OS and architecture (including Rosetta 2 for Apple Silicon)
  • Downloads from primary CDN, falls back to GitHub Releases
  • Verifies SHA-256 checksums before installing
  • Configures PATH if needed
  • Installs lukan, lukan-desktop, and lukan-bridge to ~/.local/bin/

​
Supported platforms

OSArchitecture
Linux (glibc)x86_64, arm64
macOSx86_64, arm64 (Apple Silicon)
Alpine/musl and Windows are not supported. Use WSL on Windows.

​
Install specific version

curl -fsSL https://get.lukan.ai/install.sh | bash -s v1.2.3

​
Verify installation

lukan --version
If the command returns a version, Lukan Agent is installed correctly.

​
First run

lukan
This opens the interactive assistant in your terminal.

​
Configure

lukan setup
This interactive wizard helps you:
  1. Select a model provider
  2. Enter your API key
  3. Set your timezone

​
Sandbox (optional)

Enable OS-level sandboxing with bwrap for secure tool execution: 
lukan sandbox setup    # Install and configure bwrap
lukan sandbox on       # Enable sandboxing
lukan sandbox status   # Check sandbox status
If your shell does not find lukan, restart your terminal session and run lukan --version again.

​
Updating

lukan update
Downloads and verifies the latest version, then reinstalls. Falls back to GitHub Releases if primary CDN is unavailable. 
lukan update --daily   # Install from the unstable/daily channel