{"id":23164,"library":"seeq","title":"Seeq SDK for Python","description":"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.","status":"active","version":"66.133.1.20260430","language":"python","source_language":"en","source_url":"https://github.com/seeq12/seeq-python-sdk","tags":["seeq","sdk","data-analytics","time-series","industrial"],"install":[{"cmd":"pip install seeq","lang":"bash","label":"Install from PyPI"}],"dependencies":[{"reason":"HTTP client for API calls","package":"requests","optional":false},{"reason":"Data manipulation for time series","package":"pandas","optional":true}],"imports":[{"note":"sdk is not a top-level module","wrong":"from seeq import sdk","symbol":"seeq","correct":"import seeq"},{"note":"Library name is seeq, not seeqsdk","wrong":"import seeqsdk","symbol":"seeq","correct":"import seeq"}],"quickstart":{"code":"import seeq\n\n# Use url, username, password from environment or config\nurl = os.environ.get('SEEQ_URL', '')\nusername = os.environ.get('SEEQ_USERNAME', '')\npassword = os.environ.get('SEEQ_PASSWORD', '')\n\n# Login using the SDK's built-in authentication\nclient = seeq.SDK(url, username=username, password=password)\n\n# Example: list worksheets\nworksheets = client.worksheets.search()\nfor ws in worksheets:\n    print(ws.name)","lang":"python","description":"Basic login and worksheet listing using environment variables for credentials."},"warnings":[{"fix":"Use `client = seeq.SDK(url=..., username=..., password=...)` instead of positional args.","message":"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.","severity":"breaking","affected_versions":">=60.0.0"},{"fix":"Replace `.search()` with `.find()` for consistency with future versions.","message":"The method `search()` on several resource objects has been deprecated. Use `find()` instead.","severity":"deprecated","affected_versions":">=65.0.0"},{"fix":"Convert timestamps using `pd.to_datetime(timestamps, unit='s', utc=True)`.","message":"When using pandas DataFrames, time zones must be handled manually. The SDK returns time series as Unix timestamps in seconds unless explicitly configured.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Upgrade to latest version: `pip install --upgrade seeq`. Then use `import seeq` and `seeq.SDK(...)`.","cause":"Old version or incorrect import path. The SDK class is in seeq.sdk in older versions.","error":"AttributeError: module 'seeq' has no attribute 'SDK'"},{"fix":"Ensure you use proper pandas vectorized operations, e.g., `df[df['column'] > 0]` instead of `if df['column'] > 0:`.","cause":"Direct comparison of Pandas DataFrame with boolean conditions without using .any()/.all().","error":"ValueError: The truth value of a DataFrame is ambiguous. Use a.any(), a.all() or a.empty()"},{"fix":"Verify your URL, username, and password. For API key auth, use `client = seeq.SDK(api_key='...')` instead.","cause":"Invalid credentials or insufficient permissions. The SDK uses API keys or token authentication.","error":"requests.exceptions.HTTPError: 403 Client Error: Forbidden for url: https://..."}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}