> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qredence.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

> System requirements and install steps for the Fleet Prime Agent workspace, Python kernel, and Qredence web UI.

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

| Component | Version | Notes                                                       |
| --------- | ------- | ----------------------------------------------------------- |
| Node.js   | 22.8.0+ | Required for the agent workspace                            |
| npm       | 11.10+  | `.npmrc` enforces a 7-day `min-release-age` on dependencies |
| pnpm      | 11+     | Required for the web workspace                              |
| Python    | 3.10+   | Required for `prime-agent-runtime` (IPython kernel)         |

Check them:

```bash theme={null}
node --version
npm --version
pnpm --version
python3 --version
```

## Install the agent

```bash theme={null}
git clone https://github.com/Qredence/fleet-prime-agent.git
cd fleet-prime-agent
npm ci
```

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](/fleet-prime-agent/reference/configuration).

Run it:

```bash theme={null}
./prime-agent.sh
```

## Install the web app

```bash theme={null}
pnpm install --dir web
pnpm --dir web --filter @prime-agent/web dev
```

The web server binds to `127.0.0.1` only. It is local-first and has no multi-user auth — see [Security](/fleet-prime-agent/reference/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](/fleet-prime-agent/reference/configuration) for the full layout and env vars.

## Verify the install

```bash theme={null}
prime-agent doctor --fix
```

`doctor` inspects the daemon, kernel, auth store, and web bridge, and fixes anything it can. See [Monitoring](/fleet-prime-agent/guides/monitoring) for the rest of the diagnostic commands.

## Next steps

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/fleet-prime-agent/quickstart">
    Run your first agent turn.
  </Card>

  <Card title="Providers and models" icon="plug" href="/fleet-prime-agent/guides/providers-and-models">
    Sign in a provider and pick a model.
  </Card>
</CardGroup>