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

# Installation

> Install the Verial CLI via npm or npx.

The Verial CLI ships with the [`@verial-ai/sdk`](/sdk/installation) npm package. Install it globally, install per-project, or run on demand via `npx`.

## Global install

```bash theme={null}
npm install -g @verial-ai/sdk
```

After installation, the `verial` binary is on your PATH:

```bash theme={null}
verial --version
```

## Per-project install

```bash theme={null}
npm install @verial-ai/sdk
```

Run via `npx`:

```bash theme={null}
npx verial --version
```

## Run without installing

```bash theme={null}
npx --yes @verial-ai/sdk --version
```

## Authenticate

Set your organization API key as an environment variable:

```bash theme={null}
export VERIAL_API_KEY=vk_xxx
```

Or pass `--api-key` on every invocation:

```bash theme={null}
verial --api-key vk_xxx <command>
```

See [Authentication](/cli/auth) for key creation, rotation, and Solver key handling.

## Verify

```bash theme={null}
verial environments list
```

If the CLI can reach the API with your key, this returns a list of environments (or an empty list for a fresh organization).

## Next Steps

<CardGroup cols={2}>
  <Card title="Overview" icon="terminal" href="/cli/overview">
    Command surface and output modes.
  </Card>

  <Card title="Authentication" icon="key" href="/cli/auth">
    API key and Solver key flows.
  </Card>
</CardGroup>