timesfm-forecasting

Forecast univariate time series with zero training using TimesFM.

321|26|Updated Mar 10, 2026
One-click install
npx skills add https://github.com/mkurman/tamux --skill timesfm-forecasting-mkurman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timesfm-forecasting
Source: https://github.com/mkurman/tamux/tree/main/skills/scientific-skills/timesfm-forecasting
Command: npx skills add https://github.com/mkurman/tamux --skill timesfm-forecasting-mkurman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires torch, timesfm, numpy, pandas, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Zero-shot forecasting of univariate time series using Google's TimesFM foundation model, enabling predictions without training a custom model.

Core Features & Use Cases

  • Zero-shot forecasting: Generate point forecasts and quantile prediction intervals for any univariate series without model training.
  • Preflight safety: Includes a mandatory system-check to verify RAM, GPU/VRAM, and Python dependencies before loading the model.
  • Covariate support: Showcases how external covariates can influence forecasts via the forecast_with_covariates API (XReg) when TimesFM 2.5+ is installed with the xreg feature.

Quick Start

Run the preflight check, load the model, and forecast your time-series data.

Frequently Asked Questions about timesfm-forecasting

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I forecast univariate time series without training a custom model?

You can forecast univariate time series without training by using zero-shot prediction with TimesFM. This foundation model generates point forecasts and quantile prediction intervals directly from your input data, bypassing the need to train a custom model.

What input formats are supported for zero-shot time-series forecasting?

Zero-shot time-series forecasting supports CSV, DataFrame, or array inputs. You can load your historical data in any of these formats to generate point forecasts and quantile prediction intervals using the ForecastConfig-driven workflow.

Do I need a specific amount of RAM or GPU VRAM to run TimesFM forecasting?

Yes, you need adequate RAM and GPU VRAM to run TimesFM forecasting. The Skill includes a mandatory preflight system check that verifies your available memory and Python dependencies before loading the model to ensure safe execution.

Can I use external covariates to influence time-series forecasts with TimesFM?

Yes, you can use external covariates to influence forecasts via the forecast_with_covariates API (XReg). This feature requires TimesFM 2.5+ to be installed with the specific xreg feature enabled.

How do I configure the forecast horizon and context window for time-series predictions?

You configure the forecast horizon and context window using a ForecastConfig-driven workflow. This setup allows you to define context, horizon, normalization, and batch sizing parameters for your time-series predictions.

What Python dependencies are required to run zero-shot time-series forecasting?

To run zero-shot time-series forecasting, you need the Python dependencies torch, timesfm, numpy, and pandas. These libraries handle model execution, array operations, and data structuring for the forecasting workflow.