A personal portfolio of Python and JavaScript packages for online time series prediction, covariance estimation, portfolio construction and black-box optimization, plus research notes.
meta/prophet
Open-source forecasting tool from Facebook for time series with multiple seasonality, trend changes and holiday effects, available for Python and R.
- Stars
- 20,474
- Forks
- 4,644
- Open issues
- 455
- Last commit
- 3 days ago
What is it?
Prophet is an automatic forecasting procedure for time series data. It fits an additive model in which non-linear trends are combined with yearly, weekly and daily seasonality, plus the effects of holidays you specify. It is designed for series with strong seasonal patterns and several seasons of history.
The model is robust to missing values and to shifts in the trend, and it typically handles outliers well. Users can add custom seasonalities, extra regressors, holiday calendars by country, and saturating growth limits. Built-in tools cover cross-validation and forecast performance metrics.
Prophet is available on PyPI as `prophet` and on CRAN for R. The project is in maintenance mode as of v1.4.0, so only bug fixes and dependency updates are being accepted.
Key features
- 01Models trends with yearly, weekly and daily seasonality plus holiday effects.
- 02Supports custom seasonalities and extra regressors.
- 03Handles missing data and trend changepoints.
- 04Includes cross-validation and forecast performance metrics.
- 05Available for Python (pip/conda) and R (CRAN).
Use cases
- Forecasting daily business metrics such as sales or traffic with weekly patterns.
- Projecting demand that spikes around holidays or promotions.
- Building baseline forecasts for capacity planning over multi-year history.
Quick start
- 1
Install the Python package from PyPI
python -m pip install prophet - 2
Or install via conda-forge
conda install -c conda-forge prophet
Things to know
- Prophet is in maintenance mode as of v1.4.0, so no new features are planned.
- Prophet works best with time series that have strong seasonal effects and several seasons of historical data.
- On Linux, building from source needs compilers and at least 4GB of memory to install.
In collections
Topics
FAQ
- What is prophet?
- Open-source forecasting tool from Facebook for time series with multiple seasonality, trend changes and holiday effects, available for Python and R. Prophet is an automatic forecasting procedure for time series data. It fits an additive model in which non-linear trends are combined with yearly, weekly and daily seasonality, plus the effects of holidays you specify. It is designed for series with strong seasonal patterns and several seasons of history.
- Is prophet free to use? What license does it have?
- prophet is open source under the MIT license. Check the license terms before using it in commercial products.
- Is prophet still maintained?
- Actively maintained. The last commit to prophet was on Nov 5, 2026.
- What can I use prophet for?
- Forecasting daily business metrics such as sales or traffic with weekly patterns. Projecting demand that spikes around holidays or promotions. Building baseline forecasts for capacity planning over multi-year history.
- How do I install prophet?
- Install the Python package from PyPI: python -m pip install prophet Or install via conda-forge: conda install -c conda-forge prophet
- Where can I get prophet?
- The source code and installation instructions are on GitHub: https://github.com/meta/prophet
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
AutoML library that trains and ensembles ML models for tabular, time series, and multimodal data with a few lines of Python.
Pretrained Transformer-based models from Amazon for zero-shot time series forecasting, including the Chronos-2 family.
Python SDK client for Nixtla's TimeGPT, a hosted pre-trained foundation model for time series forecasting and anomaly detection.
An R package that automates time series forecasting for financial data, with an AI agent, 25+ models and Azure-based parallel runs.
SciPy is an open-source Python library for mathematics, science, and engineering, built on NumPy arrays.