Google Research's foundation model for time-series forecasting.
G

Google Research's foundation model for time-series forecasting.

Google Research's foundation model for time-series forecasting.

26,286 stars
N/A forks
N/A contributors

README

Project documentation from GitHub

Google's TimesFM: A Foundation Model for Time-Series Forecasting

Time-series forecasting is everywhere—from predicting server loads and sales figures to forecasting energy demand. But building accurate models often means starting from scratch for each new dataset, wrestling with feature engineering and model architecture. What if you could use a pre-trained model that already understands the general patterns of time, ready to adapt to your specific numbers?

That’s the idea behind Google Research’s TimesFM. It’s a foundation model specifically trained for time-series forecasting. Think of it like a large language model, but instead of being trained on text, it’s been trained on a massive corpus of 100 billion real-world time-series points. The goal is to provide a strong starting point that can make accurate predictions on new series it has never seen before, with minimal fuss.

What It Does

TimesFM is a decoder-only attention model. In simpler terms, it looks at a chunk of historical data (the "context") and predicts what comes next (the "horizon"). You give it a sequence of past data points, and it outputs a sequence of future predictions. It was trained on a vast and diverse synthetic dataset generated from real data, which helps it learn universal temporal patterns. The cool part? It’s designed to be a "few-shot" learner, meaning it can often produce sensible forecasts for a new series just by looking at its past, without any retraining.

Why It's Cool

The "foundation model" approach is what sets this apart. Instead of a model tailored for stock prices or weather data, TimesFM aims to be a generalist. This has a few key advantages:

  • Zero-Shot Capability: You can feed it a completely unseen time series and get a reasonable forecast immediately. This is huge for prototyping or applications where you don’t have the time or data to train a custom model.
  • Handles Different Granularities: It works on data with various temporal resolutions (like hourly, daily, or monthly).
  • Simple Interface: The core idea is straightforward: input context, get forecast. It abstracts away much of the complexity of traditional time-series modeling.
  • Research-Backed: It’s not just a neat idea; the accompanying paper shows it achieves strong zero-shot performance compared to many trained benchmarks.

How to Try It

The code is available on GitHub. You can clone the repo and run the example to see it in action. Here’s the quick start:

# Clone the repository
git clone https://github.com/google-research/timesfm.git
cd timesfm # Follow the setup instructions in the README to install dependencies.
# The repository includes example scripts showing how to load the model
# and run inference on your

Did you like this issue?

Join our weekly newsletter

Love discovering amazing projects?

Help us continue bringing you the best open-source discoveries every week.

Back to Projects
Last updated: Apr 20, 2026