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

# Installation

> Install the seri binary on macOS, Linux or Windows, or download it yourself.

seri ships as one compiled binary per platform. There is no runtime to install alongside it.

## macOS and Linux

```sh theme={null}
curl -fsSL https://seri-agent.seriora.ai/install.sh | bash
```

Installs to `~/.local/bin`. If that directory is not on your `PATH`, the script prints the line
to add. It never edits your shell config for you.

## Windows

```powershell theme={null}
irm https://seri-agent.seriora.ai/install.ps1 | iex
```

Installs to `~\.seri\bin` and adds that directory to your user `PATH`. No admin rights are
required. Open a new terminal afterwards so the `PATH` change takes effect.

## Without piping to a shell

If you would rather not run a script straight from the internet, download the binary for your
platform from [Releases](https://github.com/lzvxck/seri-agent/releases), make it executable, and
put it somewhere on your `PATH`.

Both install scripts are short enough to read first, and both verify the download against the
`SHA256SUMS` file published with each release.

<Warning>
  That checksum catches a truncated or corrupted download. It does not catch a compromised
  release, because the sums are published alongside the binaries they describe.
</Warning>

## Check it worked

```sh theme={null}
seri --version
```

## Uninstalling

Delete the binary from wherever the installer put it (`~/.local/bin/seri`, or
`%USERPROFILE%\.seri\bin\seri.exe` on Windows). Your data outlives it, under `~/.seri/`.

| Path                                                     | Holds                                                                |
| -------------------------------------------------------- | -------------------------------------------------------------------- |
| `~/.seri/config.json`, `auth.json`, `permissions.yaml`   | settings, your signed-in account, and tools you approved permanently |
| `~/.seri/seri.db`                                        | your conversations and recorded runs                                 |
| `~/.seri/checkpoints/`                                   | undo history                                                         |
| `~/.seri/agents/`, `skills/`, `rules/`, `hooks/`, `mcp/` | the extensions you wrote for every project                           |
| `~/.seri/memories/`, `pending/`                          | what the archivist has learned, and what is staged for your review   |
| `~/.seri/rg/<key>/`                                      | the ripgrep build unpacked by the first search of each release       |

Deleting `~/.seri/rg/` on its own is always safe. The next search writes it again, and a run that
cannot write there falls back to a temporary copy.

<Note>
  On Windows the installer resolves its target from `%USERPROFILE%` while seri resolves your data
  directory from `$HOME`. If you have set `HOME` to something other than your user profile, the
  binary and your data live under two different `.seri` directories.
</Note>