Skip to content

Getting started

Install NativePi

NativePi is distributed through GitHub Releases for Windows, macOS, and Linux. A pinned Pi build is included, so you do not need to install Pi separately.

Download

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

Install by platform

  • 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.

Updates

NativePi checks GitHub Releases at startup and periodically for a newer version. It notifies you first; downloading and installing remain explicit actions. Installing an update stops active agent turns and terminals before the app restarts.

Uninstall

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.