As a backend project, facebook/prophet has picked up 20.5k stars on GitHub (Python). Tool for producing high quality forecasts for time series data that has multiple seasonality with linear or non-linear growth.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
2026 Update: Prophet is in maintenance mode as of v1.4.0. Only bug fixes, dependency bumps, and changes to the R package to meet parity with Python will be accepted. No new features are planned.
2023 Update: We discuss our plans for the future of Prophet in this blog post: facebook/prophet in 2023 and beyond
Prophet is a procedure for forecasting time series data based on an additive model where non-linear trends are fit with yearly, weekly, and daily seasonality, plus holiday effects. It works best with time series that have strong seasonal effects and several seasons of historical data. Prophet is robust to missing data and shifts in the trend, and typically handles outliers well.
Prophet is open source software released by Facebook's Core Data Science team. It is available for download on CRAN and PyPI.
Important links
Homepage: https://facebook.github.io/prophet/
HTML documentation: https://facebook.github.io/prophet/docs/quick_start.html
Prophet paper: Sean J. Taylor, Benjamin Letham (2018) Forecasting at scale. The American Statistician 72(1):37-45 (https://peerj.com/preprints/3190.pdf).
Helter Skelter, simplified Prophet reimplementation, written in Scala/Apache Spark, optimized for distributed computing: https://github.com/AmadeusITGroup/HelterSkelter
Installation in R - CRAN
⚠️ The CRAN version of prophet is fairly outdated. To get the latest bug fixes and updated country holiday data, we suggest installing the latest release.
Prophet is a CRAN package so you can use install.packages.
You can also choose an experimental alternative stan backend called cmdstanr. Once you've installed prophet,
follow these instructions to use cmdstanr instead of rstan as the backend:
# R
# We recommend running this in a fresh R session or restarting your current session
install.packages(c("cmdstanr", "posterior"), repos = c("https://stan-dev.r-universe.dev", getOption("repos")))
# If you haven't installed cmdstan before, run:
cmdstanr::install_cmdstan()
# Otherwise, you can point cmdstanr to your cmdstan path:
cmdstanr::set_cmdstan_path(path = <your existing cmdstan>)
# Set the R_STAN_BACKEND environment variable
Sys.setenv(R_STAN_BACKEND = "CMDSTANR")
Windows
On Windows, R requires a compiler so you'll need to follow the instructions provided by rstan. The key step is installing Rtools before attempting to install the package.
If you have custom Stan compiler settings, install from source rather than the CRAN binary.
Installation in Python - PyPI release
Prophet is on PyPI, so you can use pip to install it.
python -m pip install prophet
From v0.6 onwards, Python 2 is no longer supported.
As of v1.0, the package name on PyPI is "prophet"; prior to v1.0 it was "fbprophet".
As of v1.1, the minimum supported Python version is 3.7.
After installation, you can get started!
Anaconda
Prophet can also be installed through conda-forge.
conda install -c conda-forge prophet
Installation in Python - Development version
To get the latest code changes as they are merged, you can clone this repo and build from source manually. This is not guaranteed to be stable.
By default, Prophet will use a fixed version of cmdstan (downloading and installing it if necessary) to compile the model executables. If this is undesired and you would like to use your own existing cmdstan installation, you can set the environment variable PROPHET_REPACKAGE_CMDSTAN to False:
Make sure compilers (gcc, g++, build-essential) and Python development tools (python-dev, python3-dev) are installed. In Red Hat systems, install the packages gcc64 and gcc64-c++. If you are using a VM, be aware that you will need at least 4GB of memory to install prophet, and at least 2GB of memory to use prophet.
Windows
Using cmdstanpy with Windows requires a Unix-compatible C compiler such as mingw-gcc. If cmdstanpy is installed first, one can be installed via the cmdstanpy.install_cxx_toolchain command.
Apache Spark
Helter Skelter is a simplified reimplementation of Prophet's core forecasting approach, written natively in Scala and designed to run on Apache Spark. The algorithm is optimized for the JVM ecosystem and was built from the ground up for large-scale distributed computing.
Helter Skelter is developed and maintained by Amadeus.
GitHub repository: Helter Skelter
Maven Central artifacts:
Scala 2.12: helter-skelter_2.12
Scala 2.13: helter-skelter_2.13
Changelog
See Release Notes.
Version 1.5.0 (2026.10.05)
Python
Fixed cross_validate with shared seasonality conditions and ensured its executor pools are closed.
Fixed performance_metrics mutating the metrics list passed by the caller.
Fixed MAP parameter shapes when the history is constant.
Moved performance_metrics and the built-in metrics into a new prophet.metrics module to resolve a circular import. They remain importable from prophet.diagnostics.
Added CPython 3.14 wheel builds and refreshed the macOS CI runners.
Version 1.4.0 (2026.08.01)
Python
Supported nested Prophet models for extra regressors.
Publish (static) API docs.
Version 1.3.0 (2026.01.27)
Python
Support pandas>=3.0 and numpy>=2.4.
Version 1.2.2 (2026.01.25)
Python
Version constraints on pandas (<3) and numpy (<2.4).
R
Update build requirements to C++17 to Comply with CRAN Policy.
Add .tar.gz upload for R package to CI.
Re-generated holidays.csv for R package.
Version 1.2.1 (2025.10.22)
Python
Also copy makefile to fake cmdstan.
Version 1.2.0 (2025.05.30)
Python
Use latest CmdStan.
Add null check to CmdStanPyBackend cleanup() function.
Version 1.1.7 (2025.05.30)
Python
Enable creation of custom performance metrics.
chore: address pandas futurewarning from "M" being deprecated.
cleanup() for cross_validate.
Version 1.1.6 (2024.09.29)
Python
Bug fixes: include predictions for dates with missing y the history, zero division error in cross validation metrics.
Changed NDArray[np.float_] to NDArray[np.float64] to be compatible with numpy 2.0
R
Updated holidays data based on holidays version 0.57.
Version 1.1.5 (2023.10.10)
Python
Upgraded cmdstan version to 2.33.1, enabling Apple M2 support.
Added pre-built wheels for macOS arm64 architecture (M1, M2 chips)
Added argument scaling to the Prophet() instantiation. Allows minmax scaling on y instead of
absmax scaling (dividing by the maximum value). scaling='absmax' by default, preserving the
behaviour of previous versions.
Added argument holidays_mode to the Prophet() instantiation. Allows holidays regressors to have
a different mode than seasonality regressors. holidays_mode takes the same value as seasonality_mode
if not specified, preserving the behaviour of previous versions.
Added two methods to the Prophet object: preprocess() and calculate_initial_params(). These
do not need to be called and will not change the model fitting process. Their purpose is to provide
clarity on the pre-processing steps taken (y scaling, creating fourier series, regressor scaling,
setting changepoints, etc.) before the data is passed to the stan model.
Added argument extra_output_columns to cross_validation(). The user can specify additional columns
from predict() to include in the final output alongside ds and yhat, for example extra_output_columns=['trend'].
prophet's custom hdays module was deprecated last version and is now removed.
R
Updated holidays data based on holidays version 0.34.
Version 1.1.4 (2023.05.30)
Python
We now rely solely on holidays package for country holidays.
Upgraded cmdstan version to 2.31.0, enabling Apple M1 support.
Fixed bug with Windows installation caused by long paths.
R
Updated holidays data based on holidays version 0.25.
Version 1.1.2 (2023.01.20)
Python
Sped up .predict() by up to 10x by removing intermediate DataFrame creations.
Sped up fourier series generation, leading to at least 1.5x speed improvement for train() and predict() pipelines.
Fixed bug in how warm start values were being read.
Wheels are now version-agnostic.
R
Fixed a bug in construct_holiday_dataframe()
Updated holidays data based on holidays version 0.18.
Version 1.1.1 (2022.09.08)
(Python) Improved runtime (3-7x) of uncertainty predictions via vectorization.
Bugfixes relating to Python package versions and R holiday objects.
Version 1.1 (2022.06.25)
Replaced pystan2 dependency with cmdstan + cmdstanpy.
Pre-packaged model binaries for Python package, uploaded binary distributions to PyPI.
Improvements in the stan model code, cross-validation metric calculations, holidays.
Version 1.0 (2021.03.28)
Python package name changed from fbprophet to prophet
Fixed R Windows build issues to get latest version back on CRAN
Improvements in serialization, holidays, and R timezone handling
Plotting improvements
Version 0.7 (2020.09.05)
Built-in json serialization
Added "flat" growth option
Bugfixes related to holidays and pandas
Plotting improvements
Improvements in cross validation, such as parallelization and directly specifying cutoffs
Version 0.6 (2020.03.03)
Fix bugs related to upstream changes in holidays and pandas packages.
Compile model during first use, not during install (to comply with CRAN policy)
cmdstanpy backend now available in Python
Python 2 no longer supported
Version 0.5 (2019.05.14)
Conditional seasonalities
Improved cross validation estimates
Plotly plot in Python
Bugfixes
Version 0.4 (2018.12.18)
Added holidays functionality
Bugfixes
Version 0.3 (2018.06.01)
Multiplicative seasonality
Cross validation error metrics and visualizations
Parameter to set range of potential changepoints
Unified Stan model for both trend types
Improved future trend uncertainty for sub-daily data
Bugfixes
Version 0.2.1 (2017.11.08)
Bugfixes
Version 0.2 (2017.09.02)
Forecasting with sub-daily data
Daily seasonality, and custom seasonalities
Extra regressors
Access to posterior predictive samples
Cross-validation function
Saturating minimums
Bugfixes
Version 0.1.1 (2017.04.17)
Bugfixes
New options for detecting yearly and weekly seasonality (now the default)
The most recent commit recorded on facebook/prophet was 3 months ago, based on the GitHub push timestamp. The repository has 4.6k forks — one of the better signals of community interest.
How many stars does facebook/prophet have?
facebook/prophet has 20.5k GitHub stars — refresh the page for the live number, or check github.com/facebook/prophet. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
What language is facebook/prophet written in?
facebook/prophet is written primarily in Python. GitHub's language field is based on the largest share of bytes in the default branch.
What license does facebook/prophet use?
facebook/prophet is released under the MIT license. Always verify the LICENSE file directly on GitHub for the authoritative terms — license strings can be edited out of sync with a project's actual stance.
What topics is facebook/prophet associated with?
GitHub's repository topics for facebook/prophet: "forecasting", "python", "r". TopGit's editorial category is Backend.
Where can I see facebook/prophet in action?
The project maintains a homepage at https://facebook.github.io/prophet. The README tab on this page also usually contains screenshots and a quickstart.
Where do I read more about facebook/prophet?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/facebook/prophet is the definitive source.
Read full README in the tab above.
Want a second opinion on prophet?
Ask an AI that can read this page — one click and you get its take on prophet.