# Installation and Setup

Fiddler offers a **Python SDK client** that lets you connect directly to your Fiddler environment from a Jupyter Notebook or automated pipeline.

***

### Install the Fiddler Client

The client is available for download from PyPI via pip:

```python
pip install -q fiddler-client
```

### Import the Fiddler Client

Once you've installed the client, you can import the `fiddler` package into any Python script:

```python
import fiddler as fdl
```

***

### Authorize the Client

To use the Fiddler client, you will need **authorization details** that contain

* The [URL](#finding-your-url) you are connecting to
* A [personal access token](#finding-your-authorization-token) for your user

#### Find Your URL

The URL should point to **where Fiddler has been deployed** for your organization.

On-premise customers will use the URL specified by their IT operations team. If you are using Fiddler's managed cloud service, you will have been provided with a unique URL, which will be in one of the forms shown below:

```html
# Managed SaaS
https://<YOUR UNIQUE APP NAME>.fiddler.ai

# Managed SaaS Peering
https://<YOUR UNIQUE APP NAME>.cloud.fiddler.ai
```

#### Find Your Authorization Token

To find your authorization token, navigate to the **Settings** page, click the **Credentials** tab, and then use the **Create Key** button (if there is not already an authorization token for your user).

![Settings page Credentials tab displaying Create Key button](https://3700841225-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FjZC6ysdlGhDKECaPCjwm%2Fuploads%2Fgit-blob-3153ae1dd5b95c92d9714f2e76e1c061df3b2057%2F890613d-screenshot-2024-04-01-at-63042-am.png?alt=media)

#### Connect the Client to Fiddler

Once you've located the URL of your Fiddler environment and your authorization token, you can connect the Fiddler client to your environment.

```python
import fiddler as fdl

URL = 'https://app.fiddler.ai'
AUTH_TOKEN = ''

# Connect to the Fiddler client
# This call will also validate the client vs server version compatibility.

fdl.init(url=URL, token=AUTH_TOKEN)

print(f'Client version: {fdl.__version__}')
print(f'Server version: {fdl.conn.server_version}')
```

### Set Log Level

Set the log level for the desired verbosity.

```python
import fiddler as fdl
import logging

# Create and configure the root logger prior to calling init() 
logging.basicConfig(
    level=logging.WARN,
    format="%(asctime)s.%(msecs)03d [%(name)s] %(levelname)s: %(message)s",
    datefmt="%y%m%d-%H:%M:%S",
)

fdl.init(url=URL, token=AUTH_TOKEN)
```

> 📘 Info
>
> For detailed documentation on the Fiddler Python Client SDK’s many features, check out the [Python Client SDK reference](https://app.gitbook.com/s/rsvU8AIQ2ZL9arerribd/fiddler-python-client-sdk/python-client) section.