Seeq SDK for Python

66.133.1.20260430 verified Fri May 01 auth: no python

The Seeq SDK for Python provides programmatic access to the Seeq data analytics platform, enabling automation of data retrieval, analysis, and configuration tasks. Current version is 66.133.1.20260430, updated daily. Requires Python >=2.7.

pip install seeq

Common errors

error AttributeError: module 'seeq' has no attribute 'SDK' ↓

cause Old version or incorrect import path. The SDK class is in seeq.sdk in older versions.

fix

Upgrade to latest version: pip install --upgrade seeq. Then use import seeq and seeq.SDK(...).

error ValueError: The truth value of a DataFrame is ambiguous. Use a.any(), a.all() or a.empty() ↓

cause Direct comparison of Pandas DataFrame with boolean conditions without using .any()/.all().

fix

Ensure you use proper pandas vectorized operations, e.g., df[df['column'] > 0] instead of if df['column'] > 0:.

error requests.exceptions.HTTPError: 403 Client Error: Forbidden for url: https://... ↓

cause Invalid credentials or insufficient permissions. The SDK uses API keys or token authentication.

fix

Verify your URL, username, and password. For API key auth, use client = seeq.SDK(api_key='...') instead.

Warnings

breaking The SDK's authentication API changed in version 60.0.0. The old pattern `seeq.SDK()` with positional arguments may fail. Use keyword arguments and provide url, username, password explicitly. ↓

fix Use `client = seeq.SDK(url=..., username=..., password=...)` instead of positional args.

deprecated The method `search()` on several resource objects has been deprecated. Use `find()` instead. ↓

fix Replace `.search()` with `.find()` for consistency with future versions.

gotcha When using pandas DataFrames, time zones must be handled manually. The SDK returns time series as Unix timestamps in seconds unless explicitly configured. ↓

fix Convert timestamps using `pd.to_datetime(timestamps, unit='s', utc=True)`.

Imports

seeq
wrong
```
from seeq import sdk
```
correct
```
import seeq
```
sdk is not a top-level module
seeq
wrong
```
import seeqsdk
```
correct
```
import seeq
```
Library name is seeq, not seeqsdk

Quickstart

Basic login and worksheet listing using environment variables for credentials.

import seeq

# Use url, username, password from environment or config
url = os.environ.get('SEEQ_URL', '')
username = os.environ.get('SEEQ_USERNAME', '')
password = os.environ.get('SEEQ_PASSWORD', '')

# Login using the SDK's built-in authentication
client = seeq.SDK(url, username=username, password=password)

# Example: list worksheets
worksheets = client.worksheets.search()
for ws in worksheets:
    print(ws.name)