Skip to content

Getting started

Install and first run

NativePi is a Windows desktop application distributed through GitHub Releases. It bundles Pi, so this is the only thing you need to install.

Requirements

  • Windows. The host is currently Windows only. There is no macOS or Linux build.
  • Nothing else. A pinned build of Pi ships inside the installer. If you already have the Pi command line, NativePi will reuse its credentials, configuration, and sessions rather than creating its own.

Download

Grab the latest installer from GitHub Releases. Run it and pick an installation directory when prompted.

First run

NativePi opens on an empty workspace. Three things get you to a working conversation.

  1. Add a project. Use the folder button beside Projects in the left sidebar and pick a local folder. Projects stay pinned between launches.
  2. Review project trust if prompted. NativePi asks only when a project contains local extensions or skills. Trusting the folder allows that project-local code to run, so approve only folders whose contents you have reviewed.
  3. Sign in to a provider.Open Settings and authenticate whichever provider you use. Authentication is handled by Pi, and the credentials land in Pi's own storage.

Type into the composer and send. Pick a model and a thinking level from the row beneath the input at any point, including mid-run.

Running from source

You need Bun and Git.

git clone https://github.com/nonlooped/nativepi.git
cd nativepi
bun install
bun run dev

Building and testing

cd apps/desktop && bun test   # run the test suite
cd ../.. && bun run build     # build the app
bun run pack                  # package without an installer
bun run dist:win              # build the Windows installer

The desktop application lives in apps/desktop. The public graphical extension contract lives in packages/extension-api.

Uninstalling

Remove it like any other Windows application. Nothing of yours goes with it: your sessions, credentials, packages, and settings are Pi's and stay in ~/.pi/agent, ready for the Pi command line or a future install.