Install NativePi

Open the latest GitHub release and choose the file for your platform:

• Windows: NativePi-Setup-*.exe
• macOS: choose the x64 or arm64 NativePi-*.dmg
• Linux: choose the x64 or arm64 NativePi-*.AppImage

• Windows: Run the NSIS installer and choose an installation directory.
• macOS: Open the disk image and drag NativePi into Applications.
• Linux: Make the AppImage executable with chmod +x NativePi-*.AppImage, then run it.

Stable is the regular release. Nightly includes eligible app changes from main before the next stable release. Find the latest Nightly prerelease on the GitHub releases page, or switch Release channel under Settings → System → Updates in the installed app.

Nightly builds can have unfinished changes. Their versions include -nightly. and a UTC timestamp. Each installation starts on its matching channel; your later channel choice is saved. Returning to Stable can install an older stable version.

On Windows and Linux, packaged NativePi checks your selected channel at startup and every four hours, then downloads an available update automatically. It installs the downloaded update when you quit. Choose Restart and install under Settings → System → Updates to apply it sooner; restarting closes active agent turns, terminals, and browser access.

Current macOS builds are unsigned, so automatic installation is unavailable. Choose View downloads in Updates, download the Stable or Nightly DMG for your Mac, and replace NativePi in Applications.

Update controls are available on the installed desktop app, not in a development run or a connected browser. Maintainers can read the release automation guidefor the stable and Nightly publication rules.

Remove NativePi through Windows' installed-app settings, delete it from Applications on macOS, or delete the AppImage on Linux. Pi's sessions, credentials, packages, and settings remain in ~/.pi/agent.

Continue with First run after the application opens.