Lumen docsv1.0.2
← Site Download

Installation

Lumen is a desktop app for macOS. Installing it takes a minute; connecting your first model takes one more.

Requirements

WhatMinimum
SystemmacOS 14 Sonoma or later, Apple Silicon or Intel. Windows is coming soon.
ModelsAn API key for at least one provider
ProjectsAny local folder. Git is optional but recommended.

Install the app

  1. DownloadGet the disk image from the download page. One build runs on Apple Silicon and Intel.
  2. Move to ApplicationsOpen the disk image and drag Lumen into Applications.
  3. Open LumenThis early build isn't notarized by Apple yet, so on first launch macOS says it can't check the app. Open System Settings → Privacy & Security, scroll down and click Open Anyway. You only do this once.

Connect a model provider

On first launch Lumen asks for a key. Later, open Settings (⌘,) and paste an API key for each provider you want to use, then click Check. Keys are stored in the macOS Keychain and never leave your machine except to call the provider.

ModelWhere to get a key
ClaudeAnthropic Console
GPTOpenAI Platform
GeminiGoogle AI Studio
DeepSeekDeepSeek Platform
QwenAlibaba Cloud Model Studio
MistralMistral La Plateforme
GrokxAI Console
LlamaNo key: install Ollama and run ollama pull llama3.2
Tip

You don't need every provider. With one key, that model works alone as both manager and specialist. Add keys from more providers to split the work across the crew.

Next

Head to the Quickstart to create your first workspace and crew.