{"id":27393,"library":"sift-stack-py","title":"Sift","description":"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.","status":"active","version":"0.14.1","language":"python","source_language":"en","source_url":"https://github.com/sift-stack/sift/tree/main/python","tags":["sift","time-series","api-client","async"],"install":[{"cmd":"pip install sift-stack-py","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"SiftClient is in sift.client, not the top-level sift module","wrong":"from sift import SiftClient","symbol":"SiftClient","correct":"from sift.client import SiftClient"},{"note":"AsyncSiftClient is also in sift.client","wrong":"from sift.async_client import AsyncSiftClient","symbol":"AsyncSiftClient","correct":"from sift.client import AsyncSiftClient"}],"quickstart":{"code":"import os\nfrom sift.client import SiftClient\n\nclient = SiftClient(api_key=os.environ.get('SIFT_API_KEY', ''))\n# Example: list data sources\ndata_sources = client.list_data_sources()\nprint(data_sources)","lang":"python","description":"Initialize a Sift client with an API key and list data sources."},"warnings":[{"fix":"Uninstall old package (`pip uninstall sift-python`) and install `sift-stack-py`.","message":"The package was renamed from `sift-python` to `sift-stack-py` before v0.10.0. Old installations will break.","severity":"breaking","affected_versions":"<0.10.0"},{"fix":"Set SIFT_API_KEY environment variable or pass `api_key` parameter.","message":"The client requires an API key set via environment variable `SIFT_API_KEY` or passed explicitly. Never hardcode keys in code.","severity":"gotcha","affected_versions":"all"},{"fix":"Consider using `AsyncSiftClient` for new code to ensure future compatibility.","message":"The `SiftClient` sync client may be deprecated in favor of `AsyncSiftClient` in future releases (v1.0.0a9 includes both).","severity":"deprecated","affected_versions":">=0.14.0"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Use `from sift.client import SiftClient`","cause":"Wrong import path - SiftClient is in sift.client, not sift","error":"ImportError: cannot import name 'SiftClient' from 'sift'"},{"fix":"Ensure `sift-stack-py` is installed and uninstall any conflicting `sift-python` or `sift` packages.","cause":"Package not installed correctly or old package name conflict","error":"AttributeError: module 'sift' has no attribute 'client'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}