Getting Started

설치 & 첫 실행

LVIS AI 호스트 앱은 Electron 데스크톱 빌드로 OS별 패키지로 배포됩니다. 설치 → 첫 실행 → Marketplace 로그인 직전까지의 단계.

macOS arm64

Windows x64

Linux AppImage

electron-updater

`.dmg` 파일을 Applications 로 드래그. Gatekeeper 첫 실행 확인 → 메인 호스트 창 열림.

`.exe` 인스톨러 더블클릭. 시작 메뉴 등록 후 자동 실행.

`.AppImage` 파일에 실행 권한 (`chmod +x`) 부여 후 실행. latest-linux.yml 가 업데이트 매니페스트.

설치 단계

01
OS에 맞는 빌드 다운로드
5분
lvisai.xyz/#download 에서 macOS arm64 / Windows x64 / Linux AppImage 중 하나를 받습니다.
02
실행 권한 부여 & 더블클릭
macOS: 첫 실행 보안 경고 시 설정 → 개인정보 및 보안에서 「확인 없이 열기」.
Linux: chmod +x lvis-ai-*.AppImage 후 더블클릭 또는 터미널에서 실행.
03
스플래시 → 메인 호스트 (App.tsx)
LVIS 스플래시가 사라지면 채팅 본문이 비어 있는 메인 호스트가 열립니다 (src/ui/renderer/App.tsx:1249-1290). 이 시점에는 아직 어떤 플러그인도 등록되지 않은 상태.
04
deeplink 등록
lvis://
OS 가 lvis:// protocol handler 를 호스트 앱에 매핑 (src/main/lvis-protocol.ts). 이후 Marketplace 에서 “설치” 클릭 시 호스트로 routing.
05
Marketplace 로그인으로 이동
플러그인을 받기 위해서는 다음 단계인 Marketplace 로그인. 좌측 하단 “로그인” 또는 우측 상단 계정 아이콘.

첫 실행 시 권한

LVIS는 첫 실행 단계에서 외부 데이터 / 파일시스템 / 플러그인 어디에도 접근하지 않습니다. 모든 권한은 플러그인 install / 활성화 시점에 사용자 명시 grant 다이얼로그를 통해 부여됩니다. 자세한 흐름은 플러그인 권한 허용 흐름.