prophet README

The project's README from github.com/facebook/prophet. As one markdown file: README.md.

Prophet: Automatic Forecasting Procedure

Build

PyPI Version PyPI Downloads Monthly PyPI Downloads All

CRAN Version CRAN Downloads Monthly CRAN Downloads All

Conda_Version


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.

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.

install.packages('prophet')

After installation, you can get started!

Installation in R - Latest release

install.packages('remotes')
remotes::install_github('facebook/prophet@*release', subdir = 'R')

Experimental backend - cmdstanr

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

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.

git clone https://github.com/facebook/prophet.git
cd prophet/python
python -m pip install -e .

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:

export PROPHET_REPACKAGE_CMDSTAN=False; python -m pip install -e .

Linux

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.

Changelog

See Release Notes.

Version 1.4.0 (2026.08.01)

Python

Version 1.3.0 (2026.01.27)

Python

Version 1.2.2 (2026.01.25)

Python

R

Version 1.2.1 (2025.10.22)

Python

Version 1.2.0 (2025.05.30)

Python

Version 1.1.7 (2025.05.30)

Python

Version 1.1.6 (2024.09.29)

Python

R

Version 1.1.5 (2023.10.10)

Python

R

Version 1.1.4 (2023.05.30)

Python

R

Version 1.1.2 (2023.01.20)

Python

R

Version 1.1.1 (2022.09.08)

Version 1.1 (2022.06.25)

Version 1.0 (2021.03.28)

Version 0.7 (2020.09.05)

Version 0.6 (2020.03.03)

Version 0.5 (2019.05.14)

Version 0.4 (2018.12.18)

Version 0.3 (2018.06.01)

Version 0.2.1 (2017.11.08)

Version 0.2 (2017.09.02)

Version 0.1.1 (2017.04.17)

Version 0.1 (2017.02.23)

License

Prophet is licensed under the MIT license.

prophet (facebook/prophet)

Searching Database…

20.4K ·GitHub
Что это такое?Prophet — это open-source процедура для прогнозирования временных рядов: аддитивная модель подбирает нелинейные тренды с годовой, недельной и дневной сезонностью, а также учитывает эффект праздников. Она рассчитана на ряды с выраженной сезонностью и историей за несколько сезонов, хорошо справляется с пропусками в данных, сменами тренда и выбросами.
Это библиотека, которую я вызываю из своего кода, или приложение с интерфейсом?Это библиотека, а не приложение: вы вызываете её из своего кода на Python или R. Пакет для Python распространяется через PyPI, пакет для R — через CRAN.
Что должно быть на моём компьютере, чтобы всё заработало?Python 3.7 или новее (поддержка Python 2 прекращена с версии v0.6). Под капотом она компилирует модель Stan через cmdstan/cmdstanpy — фиксированная версия cmdstan скачивается автоматически, а на Windows понадобится Unix-совместимый C-компилятор, например mingw-gcc.
Есть ли подводные камни при установке, о которых стоит знать?Сборка из исходников на Linux требует gcc/g++ и python-dev, а виртуальной машине нужно минимум 4 ГБ памяти для установки и 2 ГБ для работы; на Windows для R сначала нужно установить Rtools. Готовые wheels для macOS arm64 (чипы M1/M2) уже существуют.
Что модель умеет улавливать, кроме тренда и сезонности?Эффекты праздников, пользовательские сезонности и дополнительные регрессоры (вложенные поддерживаются с версии v1.4). Рост может быть линейным, нелинейным или «плоским» — такой вариант добавили в v0.7, а смены тренда обрабатываются через changepoints.
Как понять, что мои прогнозы вообще хороши?Есть встроенная функция кросс-валидации с метриками ошибок и визуализацией. Она поддерживает параллелизацию и прямое задание точек отсчёта (cutoffs), а с версии v1.1.7 можно создавать собственные метрики качества.
Работает ли она с данными чаще, чем раз в сутки?Да — прогнозирование по внутрисуточным данным с дневной и пользовательской сезонностью добавили в v0.2, тогда же появились дополнительные регрессоры и функция кросс-валидации.
Есть ли за этим научная статья?Да: Sean J. Taylor и Benjamin Letham, 'Forecasting at scale', The American Statistician 72(1):37-45, 2018. Инструмент — open source от команды Facebook Core Data Science.
Creator
facebook
Size
67.4 MB
Stars
20.4K
Age
9y
Commits · 90 Days