Install & Compatibility
Where this runs
tested against v0.7.4 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
muslpy 3.10–3.95 runs
installs and imports cleanly · install 0.0s · import 1.544s · 200.3MB
glibcpy 3.10–3.95 runs
installs and imports cleanly · install 11.4s · import 1.498s · 200MB
210MB installed
● package 210MB
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
NixtlaClient
✓ from nixtla import NixtlaClient
✗ from nixtla import TimeGPT
TimeGPT was renamed to NixtlaClient in v0.7.0. Using TimeGPT still works but is deprecated.
Initialize client with API key from environment variable and generate a 3-step forecast.
import os
from nixtla import NixtlaClient
client = NixtlaClient(api_key=os.environ.get('NIXTLA_API_KEY', ''))
import pandas as pd
df = pd.DataFrame({
'timestamp': pd.date_range(start='2020-01-01', periods=10, freq='D'),
'value': range(10)
})
forecast = client.forecast(df, h=3, time_col='timestamp', target_col='value')
print(forecast)
nixtla --version
Errors
Common errors & fixes
ImportError: cannot import name 'TimeGPT' from 'nixtla'
TimeGPT was renamed to NixtlaClient in v0.7.0.
fixChange import to `from nixtla import NixtlaClient`.
nixtla.core.exceptions.ApiError: 401 Client Error: Unauthorized
API key is missing or invalid.
fixEnsure `NIXTLA_API_KEY` environment variable is set or pass `api_key` parameter to `NixtlaClient`.
KeyError: 'time_col' not found in dataframe columns
The `time_col` argument does not match any column in the provided DataFrame.
fixCheck column names and ensure `time_col` refers to a valid column.
Upgrade
Version history
0.7.4latest on PyPI · released May 5, 2026
Audit
Dependencies
pandasrequiredRequired for data handling; pinned <3.0.0.