home / docs / quickstart
docs

Quick Start

Get up and running in 5 steps.

01

Install Lukan

CLI only — includes TUI + Web UI

$ curl -fsSL https://get.lukan.ai/install.sh | bash

Or with Desktop app

$ curl -fsSL https://get.lukan.ai/install.sh | bash -s -- --desktop

Or use Docker

$ docker pull lukanlabs/lukan
$ docker run -d -p 3000:3000 --name lukan lukanlabs/lukan

Web UI available at http://localhost:3000. Enter the container and follow steps 2–5.

02

Authenticate or configure your provider

OAuth providers — no API key needed

$ lukan codex-auth
$ lukan copilot-auth

API key providers — Anthropic, Fireworks, Gemini, Nebius, etc.

$ lukan setup

Enter your API key when prompted.

03

Select which models you want available

Choose which models from your provider will appear in the /model selector.

$ lukan models openai-codex
$ lukan models anthropic
$ lukan models <provider>

Opens an interactive selector — pick which models to make available.

04

Start the agent

Terminal UI — default

$ lukan

Web UI — opens browser at http://localhost:3000

$ lukan chat --ui web

Desktop app

$ lukan chat --desktop
05

Select your model inside the chat

Once inside the chat, type:

/model

Shows the models you selected in step 3. Pick one and start chatting.

install → auth/setup → select models → chat → /model

Run lukan doctor anytime to check your configuration and troubleshoot issues.

Continue your last session

$ lukan chat -c