Sift

0.14.1 verified Fri May 01 auth: no python

Python client library for the Sift API (sift-stack/sift). The library provides async and sync clients for interacting with Sift, a platform for managing and querying time series data from engineering systems. Current version is 0.14.1, with a pre-release v1.0.0a9 available. The library requires Python >=3.8 and is actively developed.

pip install sift-stack-py

Common errors

error ImportError: cannot import name 'SiftClient' from 'sift' ↓

cause Wrong import path - SiftClient is in sift.client, not sift

fix

Use from sift.client import SiftClient

error AttributeError: module 'sift' has no attribute 'client' ↓

cause Package not installed correctly or old package name conflict

fix

Ensure sift-stack-py is installed and uninstall any conflicting sift-python or sift packages.

Warnings

breaking The package was renamed from `sift-python` to `sift-stack-py` before v0.10.0. Old installations will break. ↓

fix Uninstall old package (`pip uninstall sift-python`) and install `sift-stack-py`.

gotcha The client requires an API key set via environment variable `SIFT_API_KEY` or passed explicitly. Never hardcode keys in code. ↓

fix Set SIFT_API_KEY environment variable or pass `api_key` parameter.

deprecated The `SiftClient` sync client may be deprecated in favor of `AsyncSiftClient` in future releases (v1.0.0a9 includes both). ↓

fix Consider using `AsyncSiftClient` for new code to ensure future compatibility.

Imports

SiftClient
wrong
```
from sift import SiftClient
```
correct
```
from sift.client import SiftClient
```
SiftClient is in sift.client, not the top-level sift module

AsyncSiftClient

wrong

from sift.async_client import AsyncSiftClient

correct

from sift.client import AsyncSiftClient

AsyncSiftClient is also in sift.client

Quickstart

Initialize a Sift client with an API key and list data sources.

import os
from sift.client import SiftClient

client = SiftClient(api_key=os.environ.get('SIFT_API_KEY', ''))
# Example: list data sources
data_sources = client.list_data_sources()
print(data_sources)