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

# Install & Pair

> Install hiair-cli and pair it with your Hiair account

## Install

You need [Python 3.11+](https://www.python.org/downloads/) and Google Chrome. Install `hiair-cli` with [uv](https://docs.astral.sh/uv/) or [pipx](https://pipx.pypa.io/) — either works, uv is faster.

<Tabs>
  <Tab title="uv">
    If you don't have uv yet:

    ```bash theme={null}
    curl -LsSf https://astral.sh/uv/install.sh | sh
    ```

    Then install the CLI:

    ```bash theme={null}
    uv tool install hiair-cli
    ```
  </Tab>

  <Tab title="pipx">
    ```bash theme={null}
    pipx install hiair-cli
    ```
  </Tab>
</Tabs>

## Pair your computer

```bash theme={null}
hiair login
```

This prints a short code and opens your browser to enter it, confirming the pairing with your Hiair account. On macOS it then asks whether to install the login worker, so applies can run in the background — say yes, or install it later with `hiair service install` (see the [command reference](/cli/commands)).

If anything looks off after installing, run `hiair doctor` — it checks Chrome, pairing, and the login worker in one pass.

## Unpairing

```bash theme={null}
hiair logout
```

Removes the token from this computer and revokes it on the server. To finish removing a computer you no longer have access to, remove the device from [hiair.ai](https://hiair.ai) directly.

## Where the token lives

Pairing stores a device token. On macOS it's kept in the **Keychain**; on other platforms — or if the Keychain isn't available — it falls back to `~/.hiair/credentials`, a file only your account can read.

<Note>
  The token only ever talks to the Hiair API it was issued for. Passing a custom `--api-url` refuses to send your token anywhere else unless you explicitly opt in — see [Troubleshooting](/cli/troubleshooting).
</Note>

Next: the full [command reference](/cli/commands), or jump straight to [applying from the CLI](/cli/apply).