KieloDocs

Desktop setup

First launch, permissions, and getting ready for onboarding.

Prerequisites

  • Kielo Desktop Node installed in /Applications (see Install)
  • macOS Apple Silicon with a discrete or integrated GPU suitable for local inference
  • Stable internet for sign-in, model downloads, and serving traffic
  • A Kielo provider account

First launch

  1. Open Kielo Desktop Node from Applications or Spotlight.
  2. On first run, the app shows a welcome screen (optional intro video) — skip or watch, then continue.
  3. Sign in when prompted. Complete OAuth in the browser.
  4. The onboarding wizard starts automatically and runs once. If you quit mid-flow, the app resumes at the last completed step on next launch.

macOS permissions

The app may request access for:

  • Network — model downloads, API gateway, job polling, speed tests
  • Local network — optional reachability checks for NAT traversal
  • Notifications — job alerts and earnings updates (optional)

Grant network access when prompted; without it the node cannot register or serve.

Disk space

Models are large (often 4–40+ GB depending on quantization). Ensure sufficient free space before downloading — the onboarding hardware scan reports available storage.

Development mode

Engineers building the desktop app locally can use VITE_DEV_API_KEY in apps/desktop/.env.development to bypass OAuth during development. This path is not used in production installs.

What happens after setup

Once onboarding completes, you land on the main dashboard where you can:

  • View hardware and benchmark summary
  • Manage downloaded models
  • Run preflight and go live
  • Monitor active jobs, tokens, and earnings

Next