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

# Configuration

> Configure CLI defaults with flags, environment variables, and local config.

## Set defaults

Store default values so you do not have to pass flags every time:

```bash theme={null}
cast config set voice-id tc_xxx
cast config set model ssfm-v21
cast config set volume 120

cast config list
cast config unset volume
```

Available keys: `voice-id`, `model`, `language`, `emotion`, `emotion-preset`, `emotion-intensity`, `volume`, `pitch`, `tempo`, `format`

## Resolution order

Settings are resolved in this priority order:

```text theme={null}
--flag  >  environment variable  >  ~/.typecast/config.yaml  >  built-in default
```

## Environment variables

Any option can be set via environment variable using the `TYPECAST_` prefix:

| Variable                     | Flag Equivalent       |
| ---------------------------- | --------------------- |
| `TYPECAST_API_KEY`           | `--api-key`           |
| `TYPECAST_VOICE_ID`          | `--voice-id`          |
| `TYPECAST_MODEL`             | `--model`             |
| `TYPECAST_LANGUAGE`          | `--language`          |
| `TYPECAST_EMOTION`           | `--emotion`           |
| `TYPECAST_EMOTION_PRESET`    | `--emotion-preset`    |
| `TYPECAST_EMOTION_INTENSITY` | `--emotion-intensity` |
| `TYPECAST_FORMAT`            | `--format`            |
| `TYPECAST_VOLUME`            | `--volume`            |
| `TYPECAST_PITCH`             | `--pitch`             |
| `TYPECAST_TEMPO`             | `--tempo`             |