Downloads — L.U.N.A. Docs

Download packaged builds from the Luna GitHub releases page when available. Source installs are available for every platform that can run Node.js, Python, and the required native desktop dependencies.

Open Latest Release View Repository

Desktop

Windows

Packaged

Windows 10/11 x64

Best option for the full desktop app, local backend, voice, vision, and OS automation.

Luna setup installer or portable zip

macOS

Source

Apple Silicon or Intel

Supported as a development/source install. A signed DMG is not published yet.

Run from source

Linux

Source

Ubuntu/Debian/Fedora and similar

Use source mode for desktop features, or Docker for a browser-accessible deployment.

Run from source or Docker

ℹ️

Full desktop features

Voice, camera, screen perception, tray controls, and OS automation work best through the desktop app because Electron can launch and manage the local backend.

Mobile

Android

APK

Android phones and tablets

Use the APK when published in releases, or build locally from the Capacitor project.

Android debug APK

iPhone / iPad

Build required

iOS and iPadOS

The repo can produce an iOS simulator package. Real devices require Apple signing.

iOS simulator build or signed local build

build mobile locally

cd frontend
npm install
npm run build
npx cap sync android
npx cap sync ios

Web and Docker

Browser

Supported

Desktop, tablet, phone, LAN devices

Use the browser UI when a local or LAN backend is running.

Run Luna web or Docker

browser UI

npm run web
# Open http://localhost:5173

Docker

cp .env.personal.example .env
docker compose up -d
# Open http://localhost:8899

Developer tools

VS Code

Extension

VS Code on desktop

Connects to the same local Luna backend and shared conversation context.

VSIX extension

Luna CLI

npm i -g luna-workspace
luna setup

Shortest first run

npx luna-workspace setup

If the npm package is not published yet, install directly from GitHub:

GitHub fallback

npm i -g github:Sehastrajit/Luna
luna setup

VS Code extension

cd integrations/vscode
npm install
npm run compile
npx vsce package

Source install

Source install is the universal fallback for Windows, macOS, and Linux. It is also the best path if you want to develop Luna or build your own packages.

terminal

git clone https://github.com/Sehastrajit/Luna.git
cd Luna
npm install
npm run luna -- setup
npm run luna -- dev