Skip to content
LVIS AI
EN|KO

Getting Started

Install & First Launch

The LVIS AI host app ships as an Electron desktop build, packaged per OS. This covers install → first launch → right up to Marketplace login.

macOS arm64
Windows x64
Linux AppImage
electron-updater

macOS (Apple Silicon)

Drag the `.dmg` file into Applications. Confirm the Gatekeeper first-run prompt → the main host window opens.

Windows 10+

Double-click the `.exe` installer. It registers in the Start menu and launches automatically.

Linux

Grant execute permission (`chmod +x`) to the `.AppImage` file and run it. latest-linux.yml is the update manifest.

Installation steps

  1. 01

    Download the build for your OS

    5 min

    Get macOS arm64 / Windows x64 / Linux AppImage from lvisai.xyz/#download.

  2. 02

    Grant execute permission & double-click

    macOS: if a first-run security warning appears, go to System Settings → Privacy & Security and choose "Open Anyway."

    Linux: run chmod +x lvis-ai-*.AppImage, then double-click or run it from a terminal.

  3. 03

    Splash screen → main host (App.tsx)

    Once the LVIS splash screen disappears, the main host opens with an empty chat body (src/ui/renderer/App.tsx:1249-1290). At this point no plugins are registered yet.

  4. 04

    Deeplink registration

    lvis://

    The OS maps the lvis:// protocol handler to the host app (src/main/lvis-protocol.ts). After this, clicking "Install" in the Marketplace routes to the host.

  5. 05

    Move on to Marketplace login

    The next step to get plugins is Marketplace login — via "Log in" at the bottom left or the account icon at the top right.

Permissions at first launch
LVIS does not access any external data, the filesystem, or plugins at first launch. All permissions are granted through an explicit user-consent dialog at plugin install / activation time. See the plugin permission grant flow for details.
Previous

LVIS AI Overview

Next

Login & First Screen