{"id":21613,"library":"nixtla","title":"Nixtla","description":"Python SDK for the Nixtla API, providing access to TimeGPT, a generative pre-trained forecasting model. Current version 0.7.3, requires Python >=3.10. Regular releases with new features and integrations.","status":"active","version":"0.7.3","language":"python","source_language":"en","source_url":"https://github.com/Nixtla/nixtla","tags":["time-series","forecasting","api-sdk","timegpt","nixtla"],"install":[{"cmd":"pip install nixtla","lang":"bash","label":"Install the SDK"}],"dependencies":[{"reason":"Required for data handling; pinned <3.0.0.","package":"pandas","optional":false}],"imports":[{"note":"TimeGPT was renamed to NixtlaClient in v0.7.0. Using TimeGPT still works but is deprecated.","wrong":"from nixtla import TimeGPT","symbol":"NixtlaClient","correct":"from nixtla import NixtlaClient"}],"quickstart":{"code":"import os\nfrom nixtla import NixtlaClient\n\nclient = NixtlaClient(api_key=os.environ.get('NIXTLA_API_KEY', ''))\n\nimport pandas as pd\ndf = pd.DataFrame({\n    'timestamp': pd.date_range(start='2020-01-01', periods=10, freq='D'),\n    'value': range(10)\n})\n\nforecast = client.forecast(df, h=3, time_col='timestamp', target_col='value')\nprint(forecast)","lang":"python","description":"Initialize client with API key from environment variable and generate a 3-step forecast."},"warnings":[{"fix":"Use `from nixtla import NixtlaClient` and replace `TimeGPT` with `NixtlaClient`.","message":"TimeGPT class renamed to NixtlaClient in v0.7.0. Old code using `from nixtla import TimeGPT` will still work temporarily but may break in future releases.","severity":"breaking","affected_versions":">=0.7.0"},{"fix":"Use `forecast` or `cross_validation` methods instead.","message":"The `insample` endpoint is deprecated as of v0.7.2.","severity":"deprecated","affected_versions":">=0.7.2"},{"fix":"Set environment variable `POSTHOG_DISABLE=1` or adjust telemetry settings.","message":"The SDK sends telemetry by default using PostHog. Environments without internet access may experience delays or errors.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Change import to `from nixtla import NixtlaClient`.","cause":"TimeGPT was renamed to NixtlaClient in v0.7.0.","error":"ImportError: cannot import name 'TimeGPT' from 'nixtla'"},{"fix":"Ensure `NIXTLA_API_KEY` environment variable is set or pass `api_key` parameter to `NixtlaClient`.","cause":"API key is missing or invalid.","error":"nixtla.core.exceptions.ApiError: 401 Client Error: Unauthorized"},{"fix":"Check column names and ensure `time_col` refers to a valid column.","cause":"The `time_col` argument does not match any column in the provided DataFrame.","error":"KeyError: 'time_col' not found in dataframe columns"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}