explaingit

facebook/prophet

Analysis updated 2026-06-21

20,179PythonAudience · dataComplexity · 3/5Setup · moderate

TLDR

A forecasting tool from Facebook that predicts future values in time series data, like daily sales or website traffic, automatically handling seasonality and holidays with minimal manual tuning.

Mindmap

mindmap
  root((repo))
    What It Does
      Time series forecasting
      Automatic seasonality
      Holiday effects
    Tech Stack
      Python package
      R package
      Stan under the hood
    Use Cases
      Sales forecasting
      Traffic prediction
      Capacity planning
    Features
      Trend changepoints
      Missing data handling
      Confidence intervals
    Getting Started
      pip or conda install
      CRAN for R users
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Forecast next month's sales figures from historical data, with weekly and yearly patterns handled automatically.

USE CASE 2

Predict website traffic for capacity planning, with built-in holiday effects requiring no manual specification.

USE CASE 3

Generate demand forecasts for supply chain or subscription businesses without needing deep time series expertise.

USE CASE 4

Detect and visualize trend changepoints in multi-year business metrics to understand when growth patterns shifted.

What is it built with?

PythonRStan

How does it compare?

facebook/prophethkuds/rag-anythingw-okada/voice-changer
Stars20,17920,14620,213
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity3/54/53/5
Audiencedatadevelopervibe coder

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Stan to be installed via pip or conda, R users install from CRAN.

In plain English

Prophet is a forecasting tool made by Facebook's data science team for predicting future values in time series data, that is, data measured over time, like daily sales figures, website traffic, or energy consumption. It is designed to produce high-quality forecasts with minimal manual tuning, making it accessible to analysts who are not forecasting specialists. The core of Prophet is an "additive model," which means it decomposes a time series into separate components, trend, yearly seasonality, weekly seasonality, daily seasonality, and the effects of holidays or special events, and adds them together to make predictions. This structure makes it particularly effective for business data that has strong repeating patterns (such as higher sales on weekends, or a spike every December) and data that spans several years of history. Prophet is also designed to handle missing data gracefully and is robust to outliers and shifts in the trend. The tool is available as both a Python and R package, installable via pip or conda (Python) or from CRAN (R). Under the hood it uses Stan, a statistical modeling platform, to fit the model parameters. You would use Prophet when you need to generate forecasts for business metrics, capacity planning, or any time-ordered dataset where you want to account for seasonality and holidays automatically, without manually specifying complex statistical models. It is well-suited for analysts and data scientists who want a reliable baseline forecast without deep time series expertise.

Copy-paste prompts

Prompt 1
Using Facebook Prophet in Python, fit a model to my daily sales CSV and forecast the next 90 days with confidence intervals.
Prompt 2
How do I add custom holiday effects to a Prophet model for a retail business with Black Friday and Christmas spikes?
Prompt 3
Show me how to tune Prophet's seasonality settings for a dataset with strong weekly patterns but no meaningful yearly trend.
Prompt 4
Use Prophet to detect trend changepoints in monthly subscription revenue data and plot where growth patterns changed.

Frequently asked questions

What is prophet?

A forecasting tool from Facebook that predicts future values in time series data, like daily sales or website traffic, automatically handling seasonality and holidays with minimal manual tuning.

What language is prophet written in?

Mainly Python. The stack also includes Python, R, Stan.

How hard is prophet to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is prophet for?

Mainly data.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.