Install PP Agent

PP Agent is a desktop app for macOS, Windows, and Linux. Installers are published on the latest GitHub release, with SHA-256 checksums in SHA256SUMS.txt.

Download

System	File
macOS (Apple silicon)	pp-agent-<version>-mac-arm64.dmg
macOS (Intel)	pp-agent-<version>-mac-x64.dmg
Windows	pp-agent-<version>-win-x64.exe
Linux	pp-agent-<version>-linux-x86_64.AppImage or …-amd64.deb

Verify a download before running it:

sha256sum -c SHA256SUMS.txt --ignore-missing

On macOS, use shasum -a 256 <file> and compare it with the matching line in SHA256SUMS.txt.

First launch

1. Open the installer and move PP Agent to Applications (macOS) or follow the installer (Windows, Linux).
2. Start the app. The agent runs in a background process, pp-agentd, which the app starts for you.
3. Continue with First run to connect a model.

Signing and SmartScreen

macOS releases are signed with a Developer ID and notarized, and Windows releases are signed, only when the maintainers have configured certificates. Unsigned builds still install, with a warning:

• macOS: if the app “is damaged” or “cannot be opened”, run xattr -dr com.apple.quarantine "/Applications/PP Agent.app" once.
• Windows: choose More info → Run anyway in SmartScreen.

Updates

The app checks for new versions on start and under Settings › General › Updates.

• Windows, Linux AppImage, and macOS builds signed with a Developer ID install updates from inside the app.
• With the .deb package, the app opens the download page instead.

Requirements

• An API key or gateway for at least one model provider. PP Agent does not ship a model.
• No account with PP Techs is required, and no PP Agent service receives your conversations.

Running the daemon on its own

The desktop app starts the daemon itself. To run it on a server, build with vp pack in apps/desktop and use node apps/desktop/dist/daemon.mjs run; install, status, and uninstall manage it as a login service. Set PP_AGENT_HOME to choose the data folder and PP_AGENT_MASTER_KEY to keep the vault key out of the operating system keychain.

Uninstall

Remove the app the usual way for your system. Your conversations, settings, and encrypted keys live in the app’s data folder and are not deleted with the app; see Data storage for the exact paths.