TimeSSM-2.5M

A 2.5M-parameter zero-shot time series forecaster built on a diagonal linear state space model (S4D), trained from scratch on 15.85 billion observations of public time series. It forecasts any horizon in one pass, outputs nine quantiles, and exposes its sampling interval as an inference-time knob: the same weights run a series at any rate.

It was trained by one person on three RTX 3090s, outside of any lab or company.

The animation is a lattice-Boltzmann flow past an obstacle shaped like the letters, 48 by 96 pixels, each pixel forecast as its own series 256 frames ahead from 1024 frames of context, with the sampling interval set from the shedding period. The red frame marks the end of the context. Mean absolute error over the horizon: 0.0094 against 0.0458 for freezing the last frame; empirical 80 % coverage 0.785.

GIFT-Eval results

97 configurations, zero-shot. MASE and CRPS are geometric means of the ratio to the official seasonal naive, as on the leaderboard. Lower is better. All numbers come from the released checkpoint, the last one of its training run; no checkpoint was picked on GIFT-Eval. The evaluation harness reproduces t0-beta's official per-configuration results on 97 of 97 configurations.

With inference-time backtest resampling

The context is resampled at several rates (decimation by 2 to 48, upsampling by 2 to 4) and forecast at each; a causal backtest on the series' own past weights the candidates and the forecasts are mixed per quantile level, with sign-flip averaging. The quantile fan is widened by nine per-level factors calibrated on the training corpus. Nothing is fitted on GIFT-Eval data. It costs 20 to 40 forecasts per series instead of one.

Bare model

One forward pass per series, no averaging, no resampling, no calibration.

Where it stands

Among the models of the GIFT-Eval leaderboard under 10M parameters, sorted by CRPS (leaderboard numbers and parameter counts from its metadata; the two TimeSSM rows and the Chronos-Bolt rows from this harness):

TTM-R3 saw GIFT-Eval data in pretraining. Above 10M for scale: Chronos-Bolt small (48M) is at 0.564 bare and 0.515 with the same resampling layer; bare against bare, TimeSSM-2.5M beats it on both metrics.

Per configuration

Ratios to the official seasonal naive, released checkpoint, with backtest resampling and bare.

How to read the numbers

• The model receives the declared sampling frequency of the series and sets its sampling interval to 24 / season, the convention of FlowState (Graf et al., 2025). It was trained this way. Evaluated without the frequency it is not the model of this card.
• Zero-shot: the training corpus excludes the GIFT-Eval sources by construction.
• The harness recomputes the leaderboard metrics from the raw data with the official seasonal-naive denominators. Chronos-Bolt numbers are from chronos-forecasting 2.3.2, whose medium- and long-horizon results differ from the leaderboard's.

Model

Six gated S4D blocks (complex diagonal state, d_model 192, d_state 32), one token per time step, a learned future token for the horizon, a quantile head with cross-attention on the context. 2,525,771 parameters. Robust arcsinh scaling and instance normalization from the context. Any horizon, no autoregressive loop. Nine quantiles, 0.1 to 0.9.

Trained on three RTX 3090s with a pinball loss on the nine quantiles, on a corpus of 106 files (LOTSA subsets at a pinned revision, four Chronos datasets, synthetic families).

Limitations

• The bare model is a short-horizon model; the resampling layer carries the medium and long terms.
• Weakest groups: 10-second cloud-operations traces, hourly data with a weekly cycle (m4_hourly), low-frequency economic series (m4 weekly and yearly).
• The resampling layer multiplies inference cost by 20 to 40.
• Univariate. The frequency must be declared; there is no detector.

Inference

pip install git+https://github.com/IUseAMouse/TimeSSM.git

import numpy as np
import torch
from timessm import from_pretrained, delta_scale

model = from_pretrained("IUseAMouse/timessm-2.5m")   # or a local directory; device="cuda" to run there

series = np.sin(np.arange(1024) * 2 * np.pi / 24)   # your history: raw values, any scale
context = torch.tensor(series, dtype=torch.float32).unsqueeze(0)   # [1, length]
w = delta_scale(24, *model.delta_range)   # season length in steps: 24 for hourly data with a daily cycle
with torch.no_grad():
    out = model.forecast(context, 48, w=w)
quantiles = out["quantiles_denorm"][0]   # [48, 9], levels 0.1 to 0.9; column 4 is the median

The first argument of delta_scale is the season length of the declared frequency, in steps: 96 for 15-minute data, 24 for hourly, 7 for daily data with a weekly cycle, 12 for monthly. The function divides 24 by it and clamps the result to the range the model was trained on, so w is 0.25 for 15-minute data and 1 for hourly data. The backtest resampling layer runs through the evaluation harness, see the repository.

Reproduction

The submitted number (MASE 0.7544, CRPS 0.5128) is produced by one command of the TimeSSM repository, whose config configs/timessm_2.5m_gift.yaml carries every inference setting of this card: the frequency rule, sign-flip averaging, backtest resampling (decimation by 2 to 48, upsampling by 2 to 4, pooled backtest on four windows) and the calibration file. The bare number is the second command.

git clone https://github.com/IUseAMouse/TimeJEPA && git clone https://github.com/IUseAMouse/TimeSSM
cd TimeJEPA && make gift-download && cd ../TimeSSM && uv sync --extra train
hf download IUseAMouse/timessm-2.5m epoch00_valloss1.2814.ckpt --local-dir .   # the checkpoint
CK=epoch00_valloss1.2814.ckpt
EVAL_CONFIG=timessm_2.5m_gift scripts/eval_ssm.sh $CK                      # MASE 0.7544, CRPS 0.5128
EVAL_CONFIG=ssm_mini_v3_freq_eval scripts/eval_ssm.sh $CK +freq_delta=true # bare: MASE 0.7985, CRPS 0.5451

The harness writes all_results.csv in the leaderboard's format and a JSON per configuration. It recomputes the leaderboard metrics from the raw data with gluonts' conventions and reproduces t0-beta's official per-configuration results on 97 of 97 configurations.

Files and license

• Weights: model.safetensors with config.json (read by timessm.from_pretrained), the calibration factors, the frequency table, and the original Lightning checkpoint epoch00_valloss1.2814.ckpt for exact reproduction through the harness.
• Code: TimeSSM (model, Apache-2.0) and TimeJEPA (harness, MIT).
• Weights license: Apache-2.0, the same as the code.

Citation

@misc{vincent2026timessm,
  author = {Vincent, Yvann},
  title  = {TimeSSM: a state space forecaster with a rate knob},
  year   = {2026},
  url    = {https://github.com/IUseAMouse/TimeSSM}
}

The frequency rule follows FlowState:

@article{graf2025flowstate,
  title   = {FlowState: Sampling Rate Invariant Time Series Forecasting},
  author  = {Graf, Lars and Ortner, Thomas and Wo{\'z}niak, Stanis{\l}aw and Pantazi, Angeliki},
  journal = {arXiv preprint arXiv:2508.05287},
  year    = {2025}
}