Last modified: Jun 16, 2026

Install Meta Prophet in Python

Meta Prophet is a powerful forecasting tool developed by Meta. It helps you make time series predictions with ease. But installing it can be tricky for beginners. This guide will show you how to install Meta Prophet in Python correctly. We will cover both pip and conda methods. You will also learn how to fix common errors.

What is Meta Prophet?

Meta Prophet is an open-source library for time series forecasting. It handles missing data and outliers well. It also works with daily, weekly, and yearly patterns. Many data scientists use it for business forecasts.

Before you install, ensure you have Python 3.7 or later. A stable internet connection is also needed. Let's start the installation process.

Prerequisites for Installation

You need a working Python environment. Check your Python version with this command:


python --version

If you see Python 3.7 or higher, you are ready. Otherwise, update Python first. You also need pip or conda installed. Most Python installations include pip by default.

Method 1: Install Prophet with pip

The simplest way is using pip. Open your terminal or command prompt. Run this command:


pip install prophet

This will download and install Prophet along with its dependencies. The process may take a few minutes. Wait for the success message.

If you encounter errors, try upgrading pip first:


pip install --upgrade pip
pip install prophet

Common pip Errors and Fixes

Sometimes you see error: command 'gcc' failed. This means you lack a C++ compiler. On Windows, install Microsoft C++ Build Tools. On Linux, run:


sudo apt-get install build-essential

On macOS, install Xcode command line tools:


xcode-select --install

Another error is pystan not found. Prophet relies on pystan for Bayesian inference. Pip should install it automatically. If not, install pystan separately:


pip install pystan

Method 2: Install Prophet with conda

If you use Anaconda, conda is easier. It handles dependencies better. Run this command in your terminal:


conda install -c conda-forge prophet

The -c conda-forge flag uses the conda-forge channel. This ensures you get the latest stable version. Conda will resolve all dependencies automatically.

This method avoids many compilation errors. It is recommended for Windows users.

Verify Your Installation

After installation, test it with a simple script. Create a file named test_prophet.py:


# Import the prophet library
from prophet import Prophet

# Create a sample dataframe
import pandas as pd
data = {
    'ds': pd.date_range(start='2023-01-01', periods=10, freq='D'),
    'y': [10, 12, 14, 13, 15, 18, 20, 22, 21, 19]
}
df = pd.DataFrame(data)

# Initialize and fit the model
model = Prophet()
model.fit(df)

# Make a future dataframe for 5 days
future = model.make_future_dataframe(periods=5)
forecast = model.predict(future)

# Display the forecast
print(forecast[['ds', 'yhat', 'yhat_lower', 'yhat_upper']].tail())

Run the script:


python test_prophet.py

You should see output like this:


          ds      yhat  yhat_lower  yhat_upper
10 2023-01-11  20.12345   18.23456   22.01234
11 2023-01-12  20.45678   18.56789   22.34567
12 2023-01-13  20.78901   18.90123   22.56789
13 2023-01-14  21.12345   19.23456   23.01234
14 2023-01-15  21.45678   19.56789   23.34567

If you see this output, Prophet is installed correctly. Congratulations!

Install Prophet in a Virtual Environment

It is good practice to use a virtual environment. This isolates your project dependencies. First, create a virtual environment:


python -m venv prophet_env

Activate it:


# On Windows
prophet_env\Scripts\activate

# On macOS/Linux
source prophet_env/bin/activate

Now install Prophet inside the environment:


pip install prophet

This keeps your global Python clean. When you are done, deactivate with deactivate.

Install Specific Version of Prophet

Sometimes you need an older version for compatibility. Use pip with the version number:


pip install prophet==1.1.0

Check available versions on PyPI. For conda, specify the version:


conda install -c conda-forge prophet=1.1.0

Always test your code with the chosen version.

Troubleshooting Common Issues

ImportError: No module named 'prophet'

This means Prophet is not installed. Double-check your environment. Ensure you installed it in the same environment you are using.

RuntimeError: pystan is not installed

Install pystan manually as shown earlier. Or use conda which handles this automatically.

Memory Error on Large Datasets

Prophet uses MCMC sampling which can be memory-intensive. Reduce the number of changepoints or use a smaller dataset. You can also set mcmc_samples=0 to use only MAP estimation.

Conclusion

Installing Meta Prophet in Python is straightforward with the right steps. Use pip for a quick setup or conda for fewer errors. Always verify with a test script. Virtual environments keep your projects organized. Now you are ready to start forecasting with Prophet.

For more advanced usage, explore the official Prophet documentation. Happy forecasting!