Skip to main content

​
Install with one command

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

Alpine/musl and Windows are not supported. Use WSL on Windows.

​
Install specific version

​
Verify installation

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

​
First run

This opens the interactive assistant in your terminal.

​
Configure

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:
If your shell does not find lukan, restart your terminal session and run lukan --version again.

​
Updating

Downloads and verifies the latest version, then reinstalls. Falls back to GitHub Releases if primary CDN is unavailable.