> ## 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.

# Quickstart

> Install Fleet Prime Agent, start a workspace from your project directory, add a model provider, and run your first agent turn.

## Prerequisites

* Node.js 22.8.0 or later
* npm 11.10 or later
* Git
* Python 3.10 or later for the managed IPython kernel

## 1. Install

Clone the repository and run the installer. It installs the pinned upstream Prime Agent runtime, the web dependencies, builds the production web bundle, and links the `fleet-agent` command.

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

The installer places a `fleet-agent` shim in `~/.local/bin`. If that directory is not on your `PATH`, the installer prints the path to add. See [Install](/fleet-prime-agent/install) for details and overrides.

## 2. Start your workspace

Run Fleet Prime Agent from the project directory you want the agent to work in:

```bash theme={null}
cd /path/to/your/project
fleet-agent
```

The launcher prints a local URL:

```
Fleet Prime interface: http://127.0.0.1:3000
```

Open it in your browser. The server binds to `127.0.0.1` and rejects non-loopback requests.

## 3. Add a provider and pick a model

On first use, add a model provider in **Settings → Providers**, or type `/login` in the composer. Then choose a model in the composer's model picker. Credentials are stored by the engine under `~/.prime/agent/` and are shared with any existing `prime-agent` install.

See [Providers and models](/fleet-prime-agent/guides/providers-and-models) for OAuth providers and OpenAI-compatible endpoints.

## 4. Run a turn

Type a request in the composer. The agent streams its work as cards: IPython cells, shell commands, file edits, plans, subagents, and interactive questions you can answer inline. Your session persists after you close the browser; reopen the workspace and resume it from the session list.

## Prefer a terminal?

The pinned engine's TUI is available as `prime-agent`, and `fleet-agent agent <args>` runs the pinned engine CLI directly. See [Terminal interface](/fleet-prime-agent/guides/terminal).

## Next steps

<CardGroup cols={2}>
  <Card title="Web workspace" icon="browser" href="/fleet-prime-agent/guides/web-workspace">
    Projects, tool cards, slash commands, attachments, and settings.
  </Card>

  <Card title="Sessions and projects" icon="folder-tree" href="/fleet-prime-agent/concepts/sessions-and-projects">
    How sessions persist, resume, and map to projects.
  </Card>
</CardGroup>