Install Meridian
Stay organized with collections
Save and categorize content based on your preferences.
Prerequisites and system recommendations
Python 3.11 or 3.12 is required to use Meridian.
We also recommend using a minimum of 1 GPU.
Install
To install Meridian, run the following command to automatically install the most
recent published version from PyPI.
Linux (GPU)
python3-mpipinstall--upgrade'google-meridian[and-cuda]'# Verify the installation:python3-c"import meridian; print(meridian.__version__)"
macOS
python3-mpipinstall--upgrade'google-meridian'# Verify the installation:python3-c"import meridian; print(meridian.__version__)"
CPU
python3-mpipinstall--upgrade'google-meridian'# Verify the installation:python3-c"import meridian; print(meridian.__version__)"
Latest
python3-mpipinstall--upgradegit+https://github.com/google/meridian.git
# Verify the installation:python3-c"import meridian; print(meridian.__version__)"
How to use the Meridian library
You can run the Meridian code programmatically using sample data with
the Getting started colab.
The Meridian model uses a holistic MCMC sampling approach called
No U Turn Sampler (NUTS)
which can be compute intensive. To help with this, GPU support has been
developed across the library (out-of-the-box) using tensors. We recommend
running your Meridian model on GPUs to get real time optimization results and
significantly reduce training time.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-06-24 UTC."],[],["Meridian requires Python 3.11 or 3.12 and recommends at least 1 GPU (V100 or T4 with 16GB RAM tested). Installation via `pip` uses: `python3 -m pip install --upgrade 'google-meridian[and-cuda]'` (Linux/GPU), `google-meridian` (macOS/CPU). CPU-only install also uses `google-meridian`. To verify the install, run: `python3 -c \"import meridian; print(meridian.__version__)\"`. The library, which uses No U-Turn Sampler, is compute-intensive, thus GPU usage is recommended for real-time optimization and faster training.\n"]]