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

# init

> Initialize the Fiddler client with connection parameters and global configuration.

This function establishes a connection to the Fiddler platform and configures
the global client state. It handles authentication, server compatibility
validation, logging setup, and creates the singleton connection instance
used throughout the client library.

## Parameters

**url** `str` *required*

The base URL to your Fiddler platform instance

**token** `str` *required*

Authentication token obtained from the Fiddler UI Credentials tab

**proxies** `dict | None` (default: None)

Dictionary mapping protocol to proxy URL for HTTP requests

**timeout** `float | tuple[float, float] | None` (default: None)

HTTP request timeout settings (float or tuple of connect/read timeouts)

**verify** `bool` (default: True)

Whether to verify server's TLS certificate (default: True)

**validate** `bool` (default: True)

Whether to validate server/client version compatibility (default: True)

## Raises

* **ValueError** – If url or token parameters are empty
* **IncompatibleClient** – If server version is incompatible with client version
* **ConnectionError** – If unable to connect to the Fiddler platform

## Examples

Basic initialization:

```python theme={null}
from fiddler_evals import init

init(
    url="https://your-instance.fiddler.ai",
    token="your-api-key"
)
```

Initialization with custom timeout and proxy:

```python theme={null}
init(
    url="https://your-instance.fiddler.ai",
    token="your-api-key",
    timeout=(10.0, 60.0),  # 10s connect, 60s read timeout
    proxies={"https": "https://proxy.company.com:8080"}
)
```

Initialization for development with relaxed settings:

```python theme={null}
init(
    url="https://your-instance.fiddler.ai",
    token="dev-token",
    verify=False,  # Skip SSL verification
    validate=False,  # Skip version compatibility check
)
```

> [!NOTE]
>
> The client retries a failed request up to 5 times, with exponential
> backoff, when the server returns HTTP 429, 500, 502, 503, or 504.

The SDK logs through the standard `logging` module under the
`fiddler_evals` logger and adds no handlers of its own; configure
logging in your application to see its messages.
