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

# Install

> Install the albus CLI, and the Python or TypeScript SDK.

## CLI

The `albus` CLI is the fastest way to run a session, and the only way to sign in
with a browser. It is a Python package; the installer picks `uv`, `pip --user`,
or `pip` inside a conda environment, in that order.

<CodeGroup>
  ```bash macOS / Linux theme={null}
  curl -fsSL https://raw.githubusercontent.com/albusgroup/albus-cli/master/install.sh | sh
  ```

  ```powershell Windows theme={null}
  irm https://raw.githubusercontent.com/albusgroup/albus-cli/master/install.ps1 | iex
  ```

  ```bash uv theme={null}
  uv tool install albus-cli
  ```

  ```bash pip theme={null}
  pip install --user albus-cli
  ```
</CodeGroup>

Pin a version by setting `ALBUS_CLI_VERSION` on the shell that reads the script,
not on `curl`:

```bash theme={null}
curl -fsSL https://raw.githubusercontent.com/albusgroup/albus-cli/master/install.sh | ALBUS_CLI_VERSION=0.1.0 sh
```

Confirm the install, then sign in:

```bash theme={null}
albus --version
albus login
```

If `albus` is not found, the install directory is not on your `PATH` — usually
`~/.local/bin`. Open a new shell, or add it.

## SDKs

<CodeGroup>
  ```bash Python theme={null}
  pip install albus-sdk
  ```

  ```bash TypeScript theme={null}
  npm install @albus-ts/sdk
  ```
</CodeGroup>

Both are generated from the same [OpenAPI
contract](https://docs.albus.sh/openapi/openapi.yaml) as the API reference and
default to `https://albus.sh/api`. They authenticate with an API key, which you
mint after signing in — see [Authenticate](/getting-started/authenticate).

Next: [authenticate](/getting-started/authenticate), then [run your first
session](/getting-started/first-session).