← all repositories
TimeCopilot/timecopilot

Time-series forecasting with an LLM referee

TimeCopilot hands the tedious work of selecting, cross-validating, and explaining time-series forecasts to an LLM agent that queries 30+ foundation models through one API.

timecopilot
Not currently ranked — collecting fresh signals.
star history

What it does

TimeCopilot is an open-source Python agent that wraps more than 30 time-series foundation models—including Amazon Chronos, Salesforce Moirai, Google TimesFM, and Nixtla TimeGPT—and puts a large language model in charge of the forecasting workflow. Feed it a dataset and, optionally, a plain-English question; it computes statistical features, runs cross-validation across candidates, selects the best performer, generates future values, and returns a structured report explaining its reasoning. The output is less a raw tensor and more a narrative complete with model comparisons, feature analyses, and a boolean flag indicating whether the winner actually beat a seasonal-naive baseline.

The interesting bit

The value is in the orchestration, not a novel neural architecture: the LLM acts as a meta-reasoning layer that reads tsfeatures output, steers model selection, and writes the justification, turning a forecasting pipeline into a conversational agent. Here, the usually invisible scaffolding—cross-validation, baseline checks, and prose explanations—is the entire point.

Key highlights

  • Claims the top spot on the GIFT-Eval benchmark, ranking above entries from AWS, Salesforce, Google, and IBM.
  • Accepted at the NeurIPS 2025 BERTs Workshop for work on agentic forecasting.
  • Supports non-OpenAI LLM endpoints via Pydantic, so you are not locked into a single provider.
  • Returns verbose, structured output including feature analysis, model rationale, and a comparison against a seasonal-naive baseline.
  • Requires Python 3.10 or newer.

Caveats

  • The README explicitly warns that macOS on Intel (x86_64) is unsupported, largely due to PyTorch dependency issues.
  • Windows users are steered toward Python 3.10 specifically, suggesting some dependency fragility on that platform.
  • While the README advertises “30+” models, it only names a handful; the full roster and how deeply each is integrated remain unclear.

Verdict

Data scientists tired of hand-writing cross-validation loops and who want an LLM to both run and narrate their forecasts will find this a useful abstraction. Researchers hunting for a novel time-series architecture should skip it—TimeCopilot is an orchestration layer, not a new model.

Frequently asked

What is TimeCopilot/timecopilot?
TimeCopilot hands the tedious work of selecting, cross-validating, and explaining time-series forecasts to an LLM agent that queries 30+ foundation models through one API.
Is timecopilot open source?
Yes — TimeCopilot/timecopilot is open source, released under the MIT license.
What language is timecopilot written in?
TimeCopilot/timecopilot is primarily written in Python.
How popular is timecopilot?
TimeCopilot/timecopilot has 582 stars on GitHub.
Where can I find timecopilot?
TimeCopilot/timecopilot is on GitHub at https://github.com/TimeCopilot/timecopilot.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.