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

# Installation

> Release binaries and the container image

graph ships as a single binary and a container image — grab whichever fits. Current release: **v0.11.0**.

## Release binaries

Tagged releases publish binaries for macOS (arm64) and Linux (x86\_64) with SHA-256 checksums.

<CardGroup cols={2}>
  <Card title="macOS (arm64)" icon="apple" href="https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-macos-arm64.tar.gz">
    Download graph-v0.11.0-macos-arm64.tar.gz
  </Card>

  <Card title="Linux (x86_64)" icon="linux" href="https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-linux-x86_64.tar.gz">
    Download graph-v0.11.0-linux-x86\_64.tar.gz
  </Card>
</CardGroup>

Or from the command line:

<Tabs>
  <Tab title="macOS (arm64)">
    ```bash theme={null}
    curl -fsSLO "https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-macos-arm64.tar.gz"
    tar xzf graph-*.tar.gz && install -m 0755 graph ~/.local/bin/
    graph --help
    ```
  </Tab>

  <Tab title="Linux (x86_64)">
    ```bash theme={null}
    curl -fsSLO "https://github.com/tylerdavis/graph/releases/download/v0.11.0/graph-v0.11.0-linux-x86_64.tar.gz"
    tar xzf graph-*.tar.gz && install -m 0755 graph ~/.local/bin/
    graph --help
    ```
  </Tab>
</Tabs>

<Info>
  On macOS, the first run of a freshly downloaded binary pauses \~1s while Gatekeeper scans it. Every run after that is instant.
</Info>

## Container image

Each release also publishes `ghcr.io/tylerdavis/graph` (tags `vX.Y.Z`, `X.Y`, `latest`): the Linux binary plus `git`, `jq`, `gh`, and `curl` — everything the [github and slack tool packs](/tools/builtins) shell out to. It doubles as the runtime for [CI jobs](/cookbook/ci-checks) (no install step) and works standalone:

```bash theme={null}
docker run --rm -e ANTHROPIC_API_KEY -e GRAPH_STORAGE=memory \
  -v "$PWD:/work" -w /work ghcr.io/tylerdavis/graph:v0.11.0 plan list
```

While the repository is private the image is too — `docker login ghcr.io` with a token that has `read:packages` first (CI jobs use the workflow's `GITHUB_TOKEN`).

## Requirements

| Requirement                      | Notes                                                                    |
| -------------------------------- | ------------------------------------------------------------------------ |
| macOS (arm64) or Linux (x86\_64) | the platforms release binaries are published for                         |
| An LLM provider key              | e.g. `ANTHROPIC_API_KEY` — see [Quickstart](/getting-started/quickstart) |

## First-run notes

* graph creates its data directory at `~/.local/share/graph/` on first use (configurable via `[settings] data_dir`).
* State is plain files under the data directory, safe under concurrent runs. Use `GRAPH_STORAGE=memory` for ephemeral runs that should leave nothing behind — see [Storage](/architecture/storage).


## Related topics

- [A custom bot identity](/cookbook/bot-identity.md)
- [Changelog](/changelog.md)