guide

Install Prime Agent safely on macOS and Linux

Prime Agent installs on macOS and Linux through an official shell-pipe installer that downloads a versioned npm tarball and verifies SHA-256 checksums. You can inspect the script before running it, install Node.js 20.6+ if needed, and then verify the CLI version. The installer is not a sandbox: model-generated code still runs with your permissions.

v v0.7.1reviewed 2026-08-09evidence officialsources S003, S005, S031, S023cutoff 2026-08-09
Home

First-party announcement, documentation, release, or installer.

Before you start

Install Node.js 20.6 or newer first, review the installer source, and decide whether your threat model requires a manual inspection step before the curl-to-shell path.

Option A: inspect, then install

# inspect the installer
curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | less

# install after inspection
curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | bash

# verify the installed version
prime-agent --version

Option B: one-line install

curl -fsSL https://app.primeintellect.ai/prime-agent/install.sh | bash

What the installer does

  • downloads a versioned npm package,
  • verifies a SHA-256 checksum,
  • bootstraps optional IPython support,
  • and writes the CLI into your user environment.

Expected output

Prime Agent v0.7.1 installed Run: prime-agent --version

Verify it worked

Verify the binary version and then open the quickstart to confirm that authentication, session creation, and the persistent kernel all behave as expected.

If something breaks

If the install misbehaves, remove the CLI, clear the local app directory, and reinstall from the same pinned release. Back up sessions before re-running the installer.