Skip to content

Installation

Pavii.Ai ships as a single installer per platform. The install includes the Pavii Engine and the OpenCode CLI — the default AI agent — so a fresh machine has a working agent from the very first session, with no extra downloads and no Node or Python setup.

PlatformPackageLink
Windows (x64)Installer (.exe)Download
macOS (Apple Silicon)Disk image (.dmg)Download
Linux (x64)AppImageDownload

All builds are published on the releases page, where you can also find additional architectures.

  1. Run the downloaded Pavii.Ai-Windows-x64-Setup.exe.
  2. If Windows SmartScreen appears, choose More info → Run anyway.
  3. Follow the installer. It installs per-user — no administrator rights needed.
  4. Launch Pavii.Ai from the Start menu.

Updates are downloaded in the background and applied silently on restart.

  1. Open the downloaded .dmg and drag Pavii.Ai into Applications.
  2. On first open, macOS may warn that the app was downloaded from the internet — choose Open.
  1. Make the AppImage executable:

    Terminal window
    chmod +x Pavii.Ai-Linux-x64.AppImage
  2. Run it:

    Terminal window
    ./Pavii.Ai-Linux-x64.AppImage
  • The desktop app — the interface you talk to.
  • Pavii Engine — a local engine that manages conversations, agents, and your data. It runs on your machine; your data directory stays local.
  • OpenCode CLI — the default coding agent, preinstalled and ready in your first session. If you already have your own OpenCode installed, yours takes priority automatically.

Next: First launch →