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

# Installation

> Installation steps for hyperlocalise, including verification and upgrades.

## Prerequisites

* macOS or Linux
* one of: installer script, prebuilt binary, `.deb`/`.rpm` package, or Go toolchain

## Install with the bootstrap script

Use the stable bootstrap URL:

```bash theme={null}
curl -fsSL https://hyperlocalise.com/install | bash
```

Pin a specific release:

```bash theme={null}
curl -fsSL https://hyperlocalise.com/install | VERSION=v1.2.3 bash
```

When you open `https://hyperlocalise.com/install` in a browser, it redirects to this page. Terminal clients such as `curl` receive the installer script flow instead.

The installer script is also attached to each GitHub release so you can review or download the tagged version directly from release assets.

## Install from source (Go)

```bash theme={null}
go install github.com/hyperlocalise/hyperlocalise@latest
```

## Build from repository

```bash theme={null}
make bootstrap
make install
```

## Verify install

```bash theme={null}
hyperlocalise version
hyperlocalise --help
```

Expected output includes commands such as `init`, `crowdin`, `run`, `check`, `eval`, `status`, `sync pull`, `sync push`, `version`, and `update`.

## Install the Hyperlocalise skill (skills.sh)

Install:

```bash theme={null}
npx skills add https://github.com/hyperlocalise/hyperlocalise --skill hyperlocalise
```

This uses the [skills.sh](https://skills.sh) installer via `npx`.

## Upgrade

Use the built-in self-update command:

```bash theme={null}
hyperlocalise update
```

Pin a specific release:

```bash theme={null}
hyperlocalise update v1.2.3
```

You can still re-run your original install method if preferred.