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

# Install Qalti

## System Requirements

Qalti is currently available for **macOS only**. We support **Apple Silicon (M-series)** processors. While Qalti may work on Intel-based Macs, performance and compatibility are not guaranteed.

To run tests, you need to have **Xcode** and **iOS Simulators** installed on your system. If Xcode or simulators are not found, Qalti will prompt you to install them.

## Installation

You can install Qalti in several ways:

### Option 1: Install via Script

Run this bash script to download and install Qalti automatically:

```bash theme={null}
curl -L -o Qalti.dmg https://github.com/qalti/qalti/releases/latest/download/Qalti.dmg
hdiutil attach Qalti.dmg -nobrowse -quiet -mountpoint /Volumes/Qalti
cp -R /Volumes/Qalti/Qalti.app /Applications/Qalti.app
hdiutil detach /Volumes/Qalti -quiet
```

### Option 2: Download Manually

Download Qalti from the [latest GitHub release](https://github.com/qalti/qalti/releases/latest).

## Running Qalti

After installation, you can run Qalti in the following ways:

### UI App

Find and Open Qalti from Applications, or run it from the terminal:

```bash theme={null}
/Applications/Qalti.app/Contents/MacOS/Qalti
```

### CLI

You can run the CLI directly from the app bundle:

```bash theme={null}
/Applications/Qalti.app/Contents/MacOS/Qalti cli --help
/Applications/Qalti.app/Contents/Resources/QaltiScheduler --help
```

To run tests via UI, CLI, or CI, you need your own OpenRouter API key.

Get a key at [openrouter.ai/keys](https://openrouter.ai/keys), then:

* Add it in Qalti Settings for UI runs
* Or set it for terminal/CI runs:

```bash theme={null}
export OPENROUTER_API_KEY="sk-or-v1-..."
```

You can also pass it explicitly in CLI commands:

```bash theme={null}
/Applications/Qalti.app/Contents/MacOS/Qalti cli ./tests/example.test --token "$OPENROUTER_API_KEY"
```