# Get setup options

- **Method:** `GET`
- **Path:** `/api/v1/setup/options`
- **Operation ID:** `setup_options_api_v1_setup_options_get`
- **Tags:** Setup

Detect GPUs and return available backend installation options for the setup screen.

## Effective servers

- `http://127.0.0.1:8100`

  Voice Creator Pro on this computer

## Responses

### 200 Successful Response

**Content type:** `application/json`

schema: `SetupOptionsResponse`

- **`best_gpu`**: `string | null`

  Name of the recommended GPU
- **`detected_gpus`**: `array of string`

  Names of detected GPU devices
- **`options`**: `array`

  Available backend installation options

  **Items:**

  schema: `SetupOptionItem`
  - **`description` (required)**: `string`

    Human-readable description of the backend
  - **`download_size` (required)**: `string`

    Estimated download size (e.g. '2.1 GB')
  - **`id` (required)**: `string`

    Backend identifier (e.g. 'cuda', 'mlx', 'cpu')
  - **`name` (required)**: `string`

    Display name for the backend option
  - **`recommended` (required)**: `boolean`

    Whether this backend is recommended for the detected hardware
  - **`gpu_name`**: `string | null`

    Detected GPU name, if applicable
- **`pending_backend`**: `string | null`

  Backend pending installation from a previous attempt

**Example:**

```json
{
  "detected_gpus": [
    ""
  ],
  "options": [
    {
      "id": "",
      "name": "",
      "gpu_name": "",
      "recommended": true,
      "download_size": "",
      "description": "",
      "additionalProperty": "anything"
    }
  ],
  "best_gpu": "",
  "pending_backend": "",
  "additionalProperty": "anything"
}
```

## Schemas

- `SetupOptionItem` — shown above.
- `SetupOptionsResponse` — shown above.