timesfm-forecasting

Forecast univariate time-series with TimesFM from CSV, DataFrame, or arrays.

22|4|Updated May 25, 2026
One-click install
npx skills add https://github.com/crazymsn/academic-skills --skill timesfm-forecasting-crazymsn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timesfm-forecasting
Source: https://github.com/crazymsn/academic-skills/tree/main/academic-skills/timesfm-forecasting
Command: npx skills add https://github.com/crazymsn/academic-skills --skill timesfm-forecasting-crazymsn

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

TimesFM time-series forecasting enables zero-shot, training-free forecasts for univariate data, streamlining decision-making by providing rapid, resource-conscious predictions.

Core Features & Use Cases

  • Zero-shot forecasting for univariate series (sales, sensor data, weather, vitals) without model training.
  • Mandatory preflight checks to verify RAM, GPU/VRAM, and disk space before loading the model, reducing crash risk.
  • Versatile inputs & outputs: accepts CSV, DataFrame, or 1-D numpy arrays and returns point forecasts with quantile prediction intervals.
  • Covariates and batching support (TimesFM 2.5+) for richer forecasts and scalable batch processing.

Quick Start

Run the preflight check and forecast workflow using the forecast_csv.py script on your CSV data.

Frequently Asked Questions about timesfm-forecasting

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

FAQPage Schema
How do I do zero-shot time-series forecasting on a CSV file without training a model?

Zero-shot time-series forecasting on a CSV file is done by passing your data directly to the pre-trained TimesFM model. The Skill accepts CSV, DataFrame, or 1-D numpy arrays as input and generates point forecasts with quantile prediction intervals without requiring any model training.

How does the preflight check work before loading TimesFM for univariate forecasting?

The preflight check verifies available RAM, GPU/VRAM, and disk space before loading the TimesFM model. This mandatory resource verification step prevents out-of-memory crashes and runtime failures during the univariate forecasting process.

Can I forecast multiple univariate time-series in batch using numpy arrays?

Batch forecasting for univariate time-series using numpy arrays is supported in TimesFM 2.5 and above. You provide inputs as a list of 1-D numpy arrays, enabling scalable batch processing for richer forecasts with covariates support.

What is the difference between zero-shot forecasting and traditional machine-learning time-series models?

Zero-shot forecasting generates predictions directly from pre-trained models without requiring historical data training. Traditional machine-learning time-series models require explicit training on your specific dataset, whereas TimesFM uses pre-trained weights to deliver immediate forecasts with quantile prediction intervals.

Why does TimesFM forecasting require checking GPU and VRAM before execution?

Checking GPU and VRAM before execution is required because the TimesFM model needs significant hardware resources to run the pre-trained weights and context-length handling. The preflight check prevents crashes by ensuring sufficient RAM, GPU memory, and disk space are available.