A Software Development Kit for 'Nixtla''s 'TimeGPT'
Overview
A Software Development Kit for working with 'Nixtla''s 'TimeGPT', a foundation model for time series forecasting. 'API' is an acronym for 'application programming interface'; this package allows users to interact with 'TimeGPT' via the 'API'. You can set and validate 'API' keys and generate forecasts via 'API' calls. It is compatible with 'tsibble' and base R. For more details visit https://www.nixtla.io/docs.
This release consolidates all changes since the last CRAN release (0.6.2), including the development versions 0.6.3 and 0.6.4.
Breaking changes
nixtlarnow requires R (>= 4.1.0).- Set default value for
id_coltounique_idinnixtla_client_historicto match the other core functions.
New features
- Added support for distinguishing between historic and future exogenous variables in the forecasting and cross-validation functions. This feature was available in the development versions 0.6.3 and 0.6.4, but not in the CRAN version (0.6.2).
Bug fixes
- Fixed an HTTP 422 error when using future exogenous variables with
h = 1. - Updated internal functions to use the
GETmethod, as thePOSTmethod is no longer supported. - Fixed in-sample timestamp reconstruction in
nixtla_client_historicfor series that share some but not all in-sample sizes. - Fixed handling of mixed date-only and datetime character
dsvalues that previously produced "failed to parse" warnings andNAtimestamps. - Made output date-format detection robust across the whole
dscolumn innixtla_client_historic,nixtla_client_detect_anomalies,nixtla_client_forecast, andnixtla_client_cross_validation, so a leading midnight value no longer truncates the time component of the remaining rows.
From NEWS.md in the release
Install
Health
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-07-01
- NOTE3 OK, 11 NOTE2026-03-10
Documentation
- Help pages
- 21 (12 internal)includes a package overview page
- Examples that run
- 18%3 run in a plain check · 14 never run
- Exported functions with examples
- 100%
- Documented parameters
- 100%
- Return-value docs
- 100%
- Help pages citing references
- 0%
- Anomaly Detection
- Cross-Validation
- Data Requirements
- Exogenous Variables
- Fine-tuning
- Get Started
- Historical Forecast
- Long-Horizon Forecasting
- Prediction Intervals
- Quantile Forecasts
Show 4 moreHide 4 vignettes
Downloads
Repository
- PRs merged (all time)
- 88%
- Median days to close, 50 most recently updated closed issues
- 10
- Median days to close, 50 most recently updated closed PRs
- 1
Stars over time
12 development-tooling and community-health practices detected across 7 families in the upstream repository
Checks run against github.com/nixtla/nixtlar on 2026-10-21.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-06-23 · The repository has a site deploy workflow
pkgdown site last built 2026-06-23
Show all practicesHide 3 practices
This repository shows signs of AI coding tools.
- Cursorfirst seen 2026-06-19Named in .Rbuildignore: .cursorNamed in .gitignore: .cursorCommits: at least 1 crediting it in the message
Dependencies
Installing nixtlar adds 36 packages (21 with compiled code, 31 MB of source tarballs). Heaviest: stringi 11 MB, ggplot2 6.0 MB, isoband 1.5 MB.
Code & Tests
Datasets
People & History
Pick two releases to compare their code metrics.
- 1.0.0Latest2026-06-23 · current release · diff ↗ ·
removed 1 export
.make_requestadded 1 export
.get_client_version - RR 4.6.0 released · 2026-04-24
- RR 4.5.0 released · 2025-04-11
- 0.6.22024-10-29 · diff ↗ ·
removed 1 export
.get_api_keyadded 2 exports
.get_client_steup, nixtla_client_setup - 0.6.12024-10-10 · diff ↗ ·
removed 2 exports
.nixtla_data_prep, date_conversionadded 6 exports
.generate_output_dates, .get_model_params, .level_from_quantiles, .make_request, .r_frequency, .transient_errors - 0.5.22024-06-01
- RR 4.4.0 released · 2024-04-24
Package metadata
- First published
- 2024-06-01
- Total releases
- 4 / 2 yrs
- License
- Apache License (>= 2.0)
- Minimum R
- ≥ 4.1.0
- Bundled data
- 119 KB / 3 files
- Download size
- 3.8 MB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("nixtlar")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-24, which the citation names so these numbers can be found later. More on citing and the projects behind them.