Skip to main content
Fleet Prime Agent has two workspaces: an npm workspace under packages/ for the agent and a pnpm workspace under web/ for the Qredence UI. You only need the second one if you want the web app.

​
Requirements

Check them:

​
Install the agent

The IPython kernel provisions lazily on first use, into ~/.prime/agent/kernel-venv/. Set PRIME_AGENT_KERNEL_PYTHON to point at an existing Python environment if you’d rather manage it yourself. See Configuration. Run it:

​
Install the web app

The web server binds to 127.0.0.1 only. It is local-first and has no multi-user auth — see Security before exposing it beyond localhost.

​
Where things live

Fleet Prime Agent stores everything under ~/.prime/agent/:
  • auth.json (mode 0600) — provider API keys and OAuth credentials
  • sessions/ — session transcripts
  • logs/ — daemon and agent logs
  • kernel-venv/ — the managed Python environment for IPython
See Configuration for the full layout and env vars.

​
Verify the install

doctor inspects the daemon, kernel, auth store, and web bridge, and fixes anything it can. See Monitoring for the rest of the diagnostic commands.

​
Next steps

Quickstart

Run your first agent turn.

Providers and models

Sign in a provider and pick a model.
Last modified on August 17, 2026