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

# Introduction

> Every cloud provider. One interface.

<img className="block dark:hidden" src="https://mintcdn.com/supercontrast/1los25QURqGztAqK/images/hero-light.svg?fit=max&auto=format&n=1los25QURqGztAqK&q=85&s=3d46d15a85fccd99b2327f68f1c55361" alt="Hero Light" width="2315" height="1010" data-path="images/hero-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/supercontrast/1los25QURqGztAqK/images/hero-dark.svg?fit=max&auto=format&n=1los25QURqGztAqK&q=85&s=ffed8b7bb58dd3b1e5cf537904dd0319" alt="Hero Dark" width="2315" height="1010" data-path="images/hero-dark.svg" />

## Install

Getting started with supercontrast is easy. You can install via pip:

```bash theme={null}
pip install supercontrast
```

## Quick Start

Supercontrast provides a unified interface for various AI tasks across different cloud providers. Here's a quick introduction on how to use it:

1. Import the necessary classes:

```python theme={null}
from supercontrast import SuperContrastClient, Task, Provider, OCRRequest
```

2. Initialize a SuperContrastClient for your desired task and provider:

```python theme={null}
client = SuperContrastClient(task=Task.OCR, providers=[Provider.GCP])
```

3. Create a request object for your task:

```python theme={null}
request = OCRRequest(image="path/to/image.png")
```

4. Make the request and handle the response:

```python theme={null}
response, metadata = client.request(request)
print(f"Response: {response}")
print(f"Metadata: {metadata}")
```

## Example

Here's a complete example that demonstrates how to use supercontrast for OCR:

```python theme={null}
from supercontrast import SuperContrastClient, Task, Provider, OCRRequest

# Initialize the client
client = SuperContrastClient(task=Task.OCR, providers=[Provider.GCP])

# Create a request
request = OCRRequest(image="https://github.com/supercontrast-ai/supercontrast/raw/main/tests/image/test_ocr.png")

# Make the request and handle the response
response, metadata = client.request(request)

# Print the results
print(f"Extracted text: {response}")
print(f"Metadata: {metadata}")
```

This example shows how to perform OCR on an image using Google Cloud Platform as the provider. The same pattern can be applied to other tasks and providers supported by supercontrast.

For other tasks, see the [Tasks](/tasks) section of the documentation.

To set up providers, see the [Providers](/providers) section of the documentation.
