explaingit

google-research/timesfm

📈 Trending19,841PythonAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

Pre-trained AI model from Google for forecasting time-series data without retraining. Feed it historical numbers, get future predictions with confidence ranges.

Mindmap

mindmap
  root((TimesFM))
    What it does
      Forecasts time series
      No retraining needed
      Quantile predictions
    How to use
      Load pre-trained model
      Set forecast horizon
      Get predictions
    Tech stack
      Python
      PyTorch
      Flax
    Integrations
      BigQuery ML
      Google Sheets
      Vertex AI
    Use cases
      Sales forecasting
      Energy usage
      Traffic prediction

Things people build with this

USE CASE 1

Forecast daily sales or revenue without training a custom model on your data.

USE CASE 2

Predict hourly electricity consumption and get confidence ranges for planning.

USE CASE 3

Estimate website traffic spikes with uncertainty bounds for capacity planning.

Tech stack

PythonPyTorchFlax

Getting it running

Difficulty · easy Time to first run · 5min
Use freely for any purpose including commercial. Keep the notice and disclose changes to the patent grant.

In plain English

TimesFM (Time Series Foundation Model) is a pre-trained AI model developed by Google Research for forecasting time-series data. A time series is any sequence of measurements taken over time, sales figures by day, electricity usage by hour, website traffic by minute. Traditional forecasting models need to be trained from scratch on your own data. TimesFM works differently: it was pre-trained on a large amount of diverse time-series data by Google and can make accurate forecasts on new datasets without any additional training, similar to how a large language model can answer questions about topics it was not explicitly fine-tuned on. You provide the model with historical data points (the context), and it predicts future values (the horizon). The current version (TimesFM 2.5) uses 200 million parameters, supports context windows of up to 16,000 time steps, and can output not just a single point forecast but also a range of quantile predictions, meaning it can tell you both the most likely future value and a confidence range around it. The code example in the README shows loading the pre-trained model, configuring it with a forecast horizon of 12 steps, and feeding in two short numerical sequences to get back predicted values and uncertainty ranges. TimesFM is integrated into several Google products, including BigQuery ML for SQL-based forecasting at scale, Google Sheets for spreadsheet users, and Vertex AI for cloud deployment. It supports fine-tuning via LoRA for adapting the model to specific datasets. The library is written in Python and supports both PyTorch and Flax backends.

Copy-paste prompts

Prompt 1
Show me how to load TimesFM and make a 12-step forecast on a simple sales dataset.
Prompt 2
How do I use TimesFM's quantile predictions to get both a best guess and a confidence range for my forecast?
Prompt 3
Can you help me fine-tune TimesFM with LoRA on my company's specific time-series data?
Prompt 4
How do I integrate TimesFM into a BigQuery ML pipeline for forecasting at scale?
Open on GitHub → Explain another repo

Generated 2026-05-18 · Model: sonnet-4-6 · Verify against the repo before relying on details.