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

# Installation

> Prerequisites and how to install fracta

## Prerequisites

<Steps>
  <Step title="Go 1.22 or later">
    Fracta is a Go binary. You need Go 1.22+ to build it from source.

    ```bash theme={null}
    go version
    ```

    Install via your platform package manager or from [golang.org/dl](https://golang.org/dl).
  </Step>

  <Step title="A runtime CLI">
    Fracta orchestrates one or more of these AI CLIs. Install at least one:

    * **Claude CLI** — {/* TODO: link to install instructions */}
    * **Codex CLI** — {/* TODO: link */}
    * **OpenCode** — {/* TODO: link */}
  </Step>

  <Step title="Optional: Docker">
    Required only for the [docker-compose deployment mode](/docs/guides/deployment/docker-compose).
  </Step>

  <Step title="Optional: A Kubernetes cluster">
    Required only for the [kubernetes deployment mode](/docs/guides/deployment/kubernetes). `kind` or `k3d` works locally.
  </Step>
</Steps>

## Build from source

```bash theme={null}
git clone https://github.com/darkquasar/fracta
cd fracta
go build -o bin/fracta .
./bin/fracta --version
```

The binary lands at `bin/fracta`. Add `bin/` to your PATH or copy the binary somewhere on PATH:

```bash theme={null}
cp bin/fracta /usr/local/bin/
```

## Verify

```bash theme={null}
fracta --help
```

You should see the list of subcommands (`spawn`, `list`, `peek`, `say`, `kill`, `init`, etc.).

## Initialize a project

From the root of your own git repository, scaffold a fracta project:

```bash theme={null}
fracta init --scaffold local             # single-machine development
fracta init --scaffold docker-compose    # containerized stack
fracta init --scaffold k8s               # Kubernetes deployment
```

This drops a complete deployment tree (`fracta.yaml`, `deployment/`, `.fracta/`) into your project. See the [`fracta init` reference](/docs/reference/cli/init) for all flags, and the per-mode quickstarts below.

## What's next

<Card title="Your First Agent" href="/docs/getting-started/first-agent">
  Spawn, peek, and clean up an agent in five minutes.
</Card>

<Card title="Pick a Deployment Mode" href="/docs/guides/deployment/overview">
  Decide whether to run fracta locally, in compose, or on kubernetes.
</Card>