TiRex-2: Generalizing TiRex to Multivariate Data and Streaming
This repository provides the pre-trained multivariate forecasting model TiRex-2 introduced in the paper TiRex-2: Generalizing TiRex to Multivariate Data and Streaming.
TiRex-2 PRO: This repository is our open-source release. TiRex-2 PRO extends it with dedicated support, streaming, hardware-optimized inference (edge, embedded, and industrial PCs, among others), fine-tuning, and classification & regression support — see TiRex-2 PRO below or contact us at contact@nx-ai.com.
TiRex-2
TiRex-2 is a pretrained time series foundation model that forecasts one or many target variates directly from their history, optionally conditioned on past and future-known covariates. A single checkpoint serves both univariate and multivariate forecasting, built on a recurrent architecture designed for efficient streaming settings — all zero-shot, with no task-specific training or fine-tuning.
TiRex-2 generalizes our original univariate model, TiRex, to multivariate forecasting with past and future covariates.
Key facts
-
Zero-shot multivariate forecasting: TiRex-2 forecasts multiple target variates out of the box, without training or fine-tuning on your data.
-
Past and future-known covariates: TiRex-2 natively conditions on past covariates and future-known covariates, such as calendar features, holidays, promotions, or scheduled interventions.
-
Small active footprint: TiRex-2 activates 38.4M parameters in univariate mode and an additional 44.1M parameters for multivariate forecasting.
Installation
Install PyTorch for your CPU or GPU, then TiRex-2:
pip install tirex-2
FAQ
See the FAQ in the documentation.
Agent plugin
Forecast time series without training or writing code in Claude Code or Codex using the TiRex-2 plugin:
Claude Code
claude plugin marketplace add NX-AI/tirex-2
claude plugin install tirex2@tirex2-plugins
Codex
codex plugin marketplace add NX-AI/tirex-2
codex plugin add tirex2@tirex2-plugins
Start a new session and ask to forecast with TiRex-2.
Getting started
The most easy way for you to get started is by checking out our "Getting Started" notebook. Moreover, you can jump straight into testing out TiRex using Google Colab. If you have cloned this repository, you can also easily start the notebook via Pixi by running:
pixi run notebook
Minimal usage predicting a simple sine wave
import torch
from tirex2 import TimeseriesType, load_model
from tirex2.plotting import plot_multivariate # requires matplotlib to be installed
# load model
model = load_model("NX-AI/TiRex-2", device="cpu") # use `device="cuda"` if cuda is available
# generate data - target expects time series of shape (n_targets, context_length)
context = torch.sin(torch.arange(128).float() / 8)
ts = TimeseriesType(target=context.unsqueeze(0), past_covariates=None, future_covariates=None)
# perform forecast - each forecast is of shape (n_targets, 9 quantiles, prediction_length)
forecast = model.forecast([ts], prediction_length=32, output_type="numpy")[0]
# visualize result
fig = plot_multivariate(ts, forecast, engine="matplotlib")
fig.show()
Covariate example
This example originates from the "Getting Started" notebook, showing the value of additional covariates.
from tirex2 import load_model
from tirex2.demo import Demo, plot_demo_forecast
# load model
model = load_model("NX-AI/TiRex-2", device="cpu") # use `device="cuda"` if cuda is available
# load data
demo = Demo.create_nonstationary_demo()
ts_univariate = demo.to_timeseries_type(include_covariates=False)
ts_multivariate = demo.to_timeseries_type(include_covariates=True)
# perform forecast - each forecast is of shape (n_targets, 9 quantiles, prediction_length)
forecasts = model.forecast(
timeseries=[ts_univariate, ts_multivariate],
prediction_length=demo.horizon,
output_type="numpy",
)
# visualize result
fig = plot_demo_forecast(demo, *forecasts, engine="matplotlib")
fig.show()
Benchmarking
To reproduce our results for the GIFT-Eval and fev-bench leaderboards, follow the instructions in /examples/gifteval/ and /examples/fevbench/, respectively.
TiRex Docker image
For detailed instructions on building and running TiRex-2 in a Docker container, see the Docker README.
TiRex-2 PRO
TiRex-2 already provides state-of-the-art performance for zero-shot prediction, so you can use this open-source release without training on your own data.
TiRex-2 PRO extends this open-source release with:
- Support: dedicated support and engagement from NXAI.
- Streaming: incremental forecast updates as new observations arrive, without recomputing forecasts over the full history.
- Speed: optimized inference, including hardware-specific optimizations for edge, embedded, and industrial PC deployments.
- Fine-tuning: models adapted to your data or pretrained on different datasets for improved performance.
- Classification & Regression: TiRex-2 adapted for classification and regression tasks.
See the full feature comparison in the docs, or contact us at contact@nx-ai.com.
Cite
If you use TiRex in your research, please cite our work:
@inproceedings{podest2026tirex2,
title = {{TiRex-2}: Generalizing {TiRex} to Multivariate Data and Streaming},
author = {Podest, Patrick and Pichler, Marco and B{\"u}rger, Elias and Z{\'o}lyomi, Levente and Voggenberger, Bernhard and Berghammer, Wilhelm and Klotz, Daniel and B{\"o}ck, Sebastian and Klambauer, G{\"u}nter and Hochreiter, Sepp},
booktitle = {Advances in Neural Information Processing Systems},
year = {2026},
eprint = {2607.01204},
archivePrefix = {arXiv},
primaryClass = {cs.LG},
url = {https://arxiv.org/abs/2607.01204}
}
Intended use and limitations
This release supports time-series forecasting as documented. High-risk applications under EU AI Act Article 6 are outside NXAI's intended purpose. NXAI has not validated this release for high-risk compliance. Users and integrators must assess suitability and meet their legal obligations. Unlawful uses, including those prohibited by EU AI Act Article 5, are not permitted. See the Intended Use Notice for details. It does not change the licence or statutory obligations.
License
TiRex-2 is licensed under the Apache License 2.0.
Metadata
Release files for tirex-2 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| tirex_2-0.5.0.tar.gz | 98.4 kB | With provenance | Details for tirex_2-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| tirex_2-0.5.0-py3-none-any.whl | Python 3 | none | any | Details for tirex_2-0.5.0-py3-none-any.whl |
Total release size: 183.1 kB
Release files / tirex_2-0.5.0.tar.gz
| Download URL | tirex_2-0.5.0.tar.gz |
|---|---|
| Size | 98.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4eedfd82b28f9dbbac8f4de57513eb5cc3d1402a4dcabccfedf81679347e7a4e
|
|
BLAKE2b-256 checksum How to use checksums |
d3d9ebf0d5e11f4ce94397223bb7532d57c9c28551cb462fcac4afba7425fe93
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logRelease files / tirex_2-0.5.0-py3-none-any.whl
| Download URL | tirex_2-0.5.0-py3-none-any.whl |
|---|---|
| Size | 84.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
aed1de741872f33a388ee28bcf5dddc46b6cb5d12d5291187c496d7f45209f26
|
|
BLAKE2b-256 checksum How to use checksums |
e0bbe3f57caa04440a0ace1fa304a6c531aece6b5afb0b20147e78b274ba85eb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logSecurity for tirex-2 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for tirex_2-0.5.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 9, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.