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:

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:

import fiddler as fdl

---

Authorize the Client

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

• The URL you are connecting to

• An 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:

# 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

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.

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.

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=TOKEN)

📘 Info

For detailed documentation on the Fiddler Python client’s many features, check out the API reference section.

---

💡 Need help? Contact us at [email protected].