# Hyperparam Desktop App

Canonical: https://hyperparam.app/docs/desktop-app

The Hyperparam Desktop app is the same application as [hyperparam.app](https://hyperparam.app) running as a native desktop app. The UI, features, and AI capabilities are identical. The desktop app adds connectors for private cloud storage and lets you bring your own AI model API keys.

## Why Use the Desktop App?

- **Private cloud storage:** browse and open files directly from AWS S3, Google Cloud Storage, and Azure Blob Storage using your existing credentials
- **Custom AI providers:** use your own Anthropic or OpenAI API keys instead of the Hyperparam-managed providers
- **Local file access:** open files from your local filesystem without uploading them

## Installation

Download the latest release from [hyperparam.app/desktop](https://hyperparam.app/desktop):

After installing, sign in with your Hyperparam account to get started.

## Storage

The desktop app intercepts requests to cloud storage URLs and authenticates them using credentials from your local environment. No credentials are sent to Hyperparam servers.

### AWS S3

The desktop app uses the standard AWS SDK credential chain, the same one used by the AWS CLI and SDKs. This includes:

- Environment variables (`AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY`)
- `~/.aws/credentials` and `~/.aws/config`
- IAM instance roles and SSO sessions

Open any `s3://bucket/path` URL in Hyperparam to browse or stream files directly.

In Settings, under AWS, you can optionally select a named profile to override the default credential chain.

### Google Cloud Storage

The desktop app uses Application Default Credentials (ADC). Authenticate with:

```bash
gcloud auth application-default login
```

Or set the `GOOGLE_APPLICATION_CREDENTIALS` environment variable to a service account key file.

Open any `https://storage.googleapis.com/bucket/...` URL to access private GCS objects.

### Azure Blob Storage

The desktop app authenticates via the Azure CLI. Run:

```bash
az login
```

Then go to Settings, open the Azure tab, enable Azure Blob Storage, and optionally enter a Subscription ID to override the CLI default.

This uses `DefaultAzureCredential`, which also picks up environment variables (`AZURE_CLIENT_ID`, `AZURE_TENANT_ID`, etc.) and managed identity in Azure-hosted environments.

## Models

By default the desktop app uses Hyperparam-managed AI providers (no API key required). In Settings, under Models, switch to "Use custom providers" to supply your own keys:

| Provider | Field | Default endpoint |
|----------|-------|-----------------|
| Anthropic | API Key + Endpoint | `https://api.anthropic.com` |
| OpenAI | API Key + Endpoint | `https://api.openai.com/v1` |

The endpoint field can be left blank or overridden to point at a compatible proxy or local inference server.

To enable or disable individual AI tools in the chat interface, open Settings and go to the Tools tab.

## Offline Mode

If the desktop app cannot reach hyperparam.app at launch, it shows an offline page. Reconnect to the internet and relaunch to resume.