Instructions to use NX-AI/TiRex with libraries, inference providers, notebooks, and local apps. Follow these links to get started.
- Libraries
- TiRex
How to use NX-AI/TiRex with TiRex:
# No code snippets available yet for this library. # To use this model, check the repository files and the library's documentation. # Want to help? PRs adding snippets are welcome at: # https://github.com/huggingface/huggingface.js
- Notebooks
- Google Colab
- Kaggle
docs: align model card with GitHub README and documentation
Browse filesAligns the model card with the README and documentation on GitHub (https://github.com/NX-AI/tirex, https://nx-ai.github.io/tirex/).
- Adds the TiRex-2 pointer, the regression model section, the ONNX model section and the Intended use and limitations section
- Adds a "Model files" table (`model.ckpt`, `tirex.onnx`)
- Replaces repo-relative links with absolute GitHub URLs so they work on the Hub
- Adds a badge header; updates the citations to the GitHub versions
- Fixes typos ("of you time series", "TiRex already provide", "These benchmark show", "Sebastinan")
Only `README.md` changes; front matter is unchanged.
README.md
CHANGED
|
@@ -9,11 +9,29 @@ license_link: https://huggingface.co/NX-AI/TiRex/blob/main/LICENSE
|
|
| 9 |
license_name: nx-ai-community-license
|
| 10 |
---
|
| 11 |
|
| 12 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 13 |
|
| 14 |
This repository provides the pre-trained forecasting model TiRex introduced in the paper
|
| 15 |
[TiRex: Zero-Shot Forecasting across Long and Short Horizons with Enhanced In-Context Learning](https://arxiv.org/abs/2505.23719).
|
| 16 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 17 |
TiRex is a 35M parameter pre-trained time series forecasting model based on [xLSTM](https://github.com/NX-AI/xlstm).
|
| 18 |
|
| 19 |
### Key Facts:
|
|
@@ -26,7 +44,7 @@ TiRex is a 35M parameter pre-trained time series forecasting model based on [xLS
|
|
| 26 |
|
| 27 |
- **State-of-the-art Performance over Long and Short Horizons**:
|
| 28 |
TiRex achieves top scores in various time series forecasting benchmarks, see [GiftEval](https://huggingface.co/spaces/Salesforce/GIFT-Eval) and [ChronosZS](https://huggingface.co/spaces/autogluon/fev-leaderboard).
|
| 29 |
-
These
|
| 30 |
|
| 31 |
## Documentation
|
| 32 |
A detailed documentation of TiRex can be found here: https://nx-ai.github.io/tirex/
|
|
@@ -60,37 +78,48 @@ data = torch.rand((5, 128)) # Sample Data (5 time series with length 128)
|
|
| 60 |
quantiles, mean = model.forecast(context=data, prediction_length=64)
|
| 61 |
```
|
| 62 |
|
| 63 |
-
We provide an extended quick start example in [examples/quick_start_tirex.ipynb](./examples/quick_start_tirex.ipynb).
|
| 64 |
-
This notebook also shows how to use the different input and output types of
|
| 65 |
You can also run it in [Google Colab](https://colab.research.google.com/github/NX-AI/tirex/blob/main/examples/quick_start_tirex.ipynb).
|
| 66 |
|
| 67 |
-
We provide notebooks to run the benchmarks: [GiftEval](./examples/gifteval/gifteval.ipynb) and [Chronos-ZS](./examples/chronos_zs/chronos_zs.ipynb).
|
| 68 |
|
| 69 |
## TiRex Classification Model
|
|
|
|
|
|
|
|
|
|
| 70 |
|
| 71 |
-
|
| 72 |
|
| 73 |
-
|
| 74 |
|
| 75 |
## TiRex Docker image
|
| 76 |
|
| 77 |
-
For detailed instructions on building and running TiRex in a Docker container, see the [Docker README](./inference/README.md) or our [deployment documentation](https://nx-ai.github.io/tirex/deployment).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 78 |
|
| 79 |
## Finetuning TiRex
|
| 80 |
-
TiRex already
|
| 81 |
|
| 82 |
If you are interested in models fine-tuned on your data or with different pretraining, please contact us at [contact@nx-ai.com](mailto:contact@nx-ai.com)
|
| 83 |
|
| 84 |
-
## Troubleshooting
|
| 85 |
-
If you have problems please check the [documentation](https://nx-ai.github.io/tirex/) and feel free to create a GitHub issue or start a discussion.
|
| 86 |
-
|
| 87 |
|
| 88 |
## CUDA Kernels
|
| 89 |
|
| 90 |
-
|
| 91 |
These CUDA kernels are compiled when the model is loaded the first time.
|
| 92 |
The CUDA kernels require GPU hardware that support CUDA compute capability 8.0 or later.
|
| 93 |
-
We also highly suggest to use the provided [conda environment spec](./requirements_cu124.yaml).
|
| 94 |
The CUDA kernels are automatically used when the xlstm package is installed.
|
| 95 |
|
| 96 |
To install TiRex with the CUDA kernels run:
|
|
@@ -136,20 +165,24 @@ If you use TiRex in your research, please cite our work:
|
|
| 136 |
title = {{{TiRex}}: {{Zero-Shot Forecasting Across Long}} and {{Short Horizons}} with {{Enhanced In-Context Learning}}},
|
| 137 |
author = {Andreas Auer and Patrick Podest and Daniel Klotz and Sebastian B{\"o}ck and G{\"u}nter Klambauer and Sepp Hochreiter},
|
| 138 |
booktitle = {The Thirty-Ninth Annual Conference on Neural Information Processing Systems},
|
| 139 |
-
year = {2025}
|
| 140 |
url = {https://arxiv.org/abs/2505.23719},
|
| 141 |
}
|
| 142 |
```
|
| 143 |
```bibtex
|
| 144 |
@inproceedings{auer:25tirexclassification,
|
| 145 |
title = {Pre-trained Forecasting Models: Strong Zero-Shot Feature Extractors for Time Series Classification},
|
| 146 |
-
author = {Andreas Auer and Daniel Klotz and
|
| 147 |
booktitle = {NeurIPS 2025 Workshop on Recent Advances in Time Series Foundation Models (BERT2S)},
|
| 148 |
year = {2025},
|
| 149 |
url = {https://arxiv.org/abs/2510.26777},
|
| 150 |
}
|
| 151 |
```
|
| 152 |
|
|
|
|
|
|
|
|
|
|
|
|
|
| 153 |
## License
|
| 154 |
|
| 155 |
-
TiRex is licensed under the [NXAI community license](./LICENSE).
|
|
|
|
| 9 |
license_name: nx-ai-community-license
|
| 10 |
---
|
| 11 |
|
| 12 |
+
<div align="center">
|
| 13 |
+
|
| 14 |
+
# TiRex: Zero-Shot Forecasting across Long and Short Horizons
|
| 15 |
+
|
| 16 |
+
[](https://arxiv.org/abs/2505.23719)
|
| 17 |
+
[](https://github.com/NX-AI/tirex)
|
| 18 |
+
[](https://pypi.org/project/tirex-ts/)
|
| 19 |
+
[](https://pepy.tech/projects/tirex-ts)
|
| 20 |
+
[](https://huggingface.co/NX-AI/TiRex/blob/main/LICENSE)
|
| 21 |
+
[](https://nx-ai.github.io/tirex/)
|
| 22 |
+
|
| 23 |
+
</div>
|
| 24 |
|
| 25 |
This repository provides the pre-trained forecasting model TiRex introduced in the paper
|
| 26 |
[TiRex: Zero-Shot Forecasting across Long and Short Horizons with Enhanced In-Context Learning](https://arxiv.org/abs/2505.23719).
|
| 27 |
|
| 28 |
+
> **TiRex-2:** A newer generation of this model is available, extending TiRex with native
|
| 29 |
+
> multivariate forecasting and past/future-known covariates. See the
|
| 30 |
+
> [TiRex-2 repository](https://github.com/NX-AI/tirex-2) and
|
| 31 |
+
> [paper](https://arxiv.org/abs/2607.01204).
|
| 32 |
+
|
| 33 |
+
## TiRex Model
|
| 34 |
+
|
| 35 |
TiRex is a 35M parameter pre-trained time series forecasting model based on [xLSTM](https://github.com/NX-AI/xlstm).
|
| 36 |
|
| 37 |
### Key Facts:
|
|
|
|
| 44 |
|
| 45 |
- **State-of-the-art Performance over Long and Short Horizons**:
|
| 46 |
TiRex achieves top scores in various time series forecasting benchmarks, see [GiftEval](https://huggingface.co/spaces/Salesforce/GIFT-Eval) and [ChronosZS](https://huggingface.co/spaces/autogluon/fev-leaderboard).
|
| 47 |
+
These benchmarks show that TiRex provides great performance for both long and short-term forecasting.
|
| 48 |
|
| 49 |
## Documentation
|
| 50 |
A detailed documentation of TiRex can be found here: https://nx-ai.github.io/tirex/
|
|
|
|
| 78 |
quantiles, mean = model.forecast(context=data, prediction_length=64)
|
| 79 |
```
|
| 80 |
|
| 81 |
+
We provide an extended quick start example in [examples/quick_start_tirex.ipynb](https://github.com/NX-AI/tirex/blob/main/examples/quick_start_tirex.ipynb).
|
| 82 |
+
This notebook also shows how to use the different input and output types of your time series data.
|
| 83 |
You can also run it in [Google Colab](https://colab.research.google.com/github/NX-AI/tirex/blob/main/examples/quick_start_tirex.ipynb).
|
| 84 |
|
| 85 |
+
We provide notebooks to run the benchmarks: [GiftEval](https://github.com/NX-AI/tirex/blob/main/examples/gifteval/gifteval.ipynb) and [Chronos-ZS](https://github.com/NX-AI/tirex/blob/main/examples/chronos_zs/chronos_zs.ipynb).
|
| 86 |
|
| 87 |
## TiRex Classification Model
|
| 88 |
+
[](http://arxiv.org/abs/2510.26777)
|
| 89 |
+
|
| 90 |
+
For detailed instructions on using TiRex classification model please visit our [documentation page](https://nx-ai.github.io/tirex/how-to/classification/) and [quick start Notebook](https://github.com/NX-AI/tirex/blob/main/examples/quick_start_tirex_classification.ipynb).
|
| 91 |
|
| 92 |
+
## TiRex Regression Model
|
| 93 |
|
| 94 |
+
For detailed instructions on using TiRex regression model please visit our [documentation page](https://nx-ai.github.io/tirex/how-to/regression/) or our [quick start Notebook](https://github.com/NX-AI/tirex/blob/main/examples/quick_start_tirex_regression.ipynb).
|
| 95 |
|
| 96 |
## TiRex Docker image
|
| 97 |
|
| 98 |
+
For detailed instructions on building and running TiRex in a Docker container, see the [Docker README](https://github.com/NX-AI/tirex/blob/main/inference/README.md) or our [deployment documentation](https://nx-ai.github.io/tirex/deployment).
|
| 99 |
+
|
| 100 |
+
## Model files
|
| 101 |
+
|
| 102 |
+
| File | Format | Notes |
|
| 103 |
+
| --- | --- | --- |
|
| 104 |
+
| [`model.ckpt`](https://huggingface.co/NX-AI/TiRex/blob/main/model.ckpt) | PyTorch checkpoint | Default. Loaded by `load_model("NX-AI/TiRex")`. |
|
| 105 |
+
| [`tirex.onnx`](https://huggingface.co/NX-AI/TiRex/blob/main/tirex.onnx) | ONNX | For optimized inference across different hardware platforms and frameworks. |
|
| 106 |
+
|
| 107 |
+
## ONNX Model
|
| 108 |
+
|
| 109 |
+
TiRex is available as an ONNX model (`tirex.onnx` in this repository) for optimized inference across different hardware platforms and frameworks. See the [ONNX notebook](https://github.com/NX-AI/tirex/blob/main/examples/tirex_onnx.ipynb) for more details.
|
| 110 |
|
| 111 |
## Finetuning TiRex
|
| 112 |
+
TiRex already provides state-of-the-art performance for zero-shot prediction. Hence, you can use it without training on your own data.
|
| 113 |
|
| 114 |
If you are interested in models fine-tuned on your data or with different pretraining, please contact us at [contact@nx-ai.com](mailto:contact@nx-ai.com)
|
| 115 |
|
|
|
|
|
|
|
|
|
|
| 116 |
|
| 117 |
## CUDA Kernels
|
| 118 |
|
| 119 |
+
TiRex can use custom CUDA kernels for the sLSTM cells.
|
| 120 |
These CUDA kernels are compiled when the model is loaded the first time.
|
| 121 |
The CUDA kernels require GPU hardware that support CUDA compute capability 8.0 or later.
|
| 122 |
+
We also highly suggest to use the provided [conda environment spec](https://github.com/NX-AI/tirex/blob/main/requirements_cu124.yaml).
|
| 123 |
The CUDA kernels are automatically used when the xlstm package is installed.
|
| 124 |
|
| 125 |
To install TiRex with the CUDA kernels run:
|
|
|
|
| 165 |
title = {{{TiRex}}: {{Zero-Shot Forecasting Across Long}} and {{Short Horizons}} with {{Enhanced In-Context Learning}}},
|
| 166 |
author = {Andreas Auer and Patrick Podest and Daniel Klotz and Sebastian B{\"o}ck and G{\"u}nter Klambauer and Sepp Hochreiter},
|
| 167 |
booktitle = {The Thirty-Ninth Annual Conference on Neural Information Processing Systems},
|
| 168 |
+
year = {2025},
|
| 169 |
url = {https://arxiv.org/abs/2505.23719},
|
| 170 |
}
|
| 171 |
```
|
| 172 |
```bibtex
|
| 173 |
@inproceedings{auer:25tirexclassification,
|
| 174 |
title = {Pre-trained Forecasting Models: Strong Zero-Shot Feature Extractors for Time Series Classification},
|
| 175 |
+
author = {Andreas Auer and Daniel Klotz and Sebastian B{\"o}ck and Sepp Hochreiter},
|
| 176 |
booktitle = {NeurIPS 2025 Workshop on Recent Advances in Time Series Foundation Models (BERT2S)},
|
| 177 |
year = {2025},
|
| 178 |
url = {https://arxiv.org/abs/2510.26777},
|
| 179 |
}
|
| 180 |
```
|
| 181 |
|
| 182 |
+
## Intended use and limitations
|
| 183 |
+
|
| 184 |
+
This release supports time-series forecasting, classification, and regression as [documented](https://nx-ai.github.io/tirex/). 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](https://github.com/NX-AI/tirex/blob/main/INTENDED_USE.md) for details. It does not change the licence or statutory obligations.
|
| 185 |
+
|
| 186 |
## License
|
| 187 |
|
| 188 |
+
TiRex is licensed under the [NXAI community license](https://huggingface.co/NX-AI/TiRex/blob/main/LICENSE).
|