Skip to content
Back to search

meridian

SkillOfficial: GoogleGitHub

Meridian is an MMM framework that enables advertisers to set up and run their own in-house models.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/google/meridian with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/google/meridian'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/google--meridian/badge.svg)](/listings/google--meridian)

HTML

<a href="/listings/google--meridian"><img src="/api/listings/google--meridian/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Python 3.11-3.13 is required to use Meridian. We also recommend using a minimum of 1 GPU.

Note: This project has been tested on T4 GPU using 16 GB of RAM.

To install Meridian, run the following command to automatically install the latest release from PyPI.

* For Linux-GPU users:

Note: CUDA toolchain and a compatible GPU device is necessary for `[and-cuda]` extra to activate.

```sh $ pip install --upgrade google-meridian[and-cuda] ```

* For macOS and general CPU users:

Note: There is no official GPU support for macOS.

```sh $ pip install --upgrade google-meridian ```

Alternatively, run the following command to install the most recent, unreleased version from GitHub.

* For GPU users:

```sh $ pip install --upgrade "google-meridian[and-cuda] @ git+https://github.com/google/meridian.git" ```

* For CPU users:

```sh $ pip install --upgrade git+https://github.com/google/meridian.git ```

We recommend to install Meridian in a fresh [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments) to make sure that correct versions of all the dependencies are installed, as defined in [pyproject.toml](https://github.com/google/meridian/blob/main/pyproject.toml).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 161 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # About Meridian
  2. Marketing mix modeling (MMM) is a statistical analysis technique that measures
  3. the impact of marketing campaigns and activities to guide budget planning
  4. decisions and improve overall media effectiveness. MMM uses aggregated data to
  5. measure impact across marketing channels and account for non-marketing factors
  6. that impact sales and other key performance indicators (KPIs). MMM is
  7. privacy-safe and does not use any cookie or user-level information.
  8. Meridian is an MMM framework that enables advertisers to set up and run their
  9. own in-house models. Meridian helps you answer key questions such as:
  10. * How did the marketing channels drive my revenue or other KPI?
  11. * What was my marketing return on investment (ROI)?
  12. * How do I optimize my marketing budget allocation for the future?
  13. Meridian is a highly customizable modeling framework that is based on
  14. [Bayesian causal inference](https://developers.google.com/meridian/docs/causal-inference/bayesian-inference).
  15. It is capable of handling large scale geo-level data, which is encouraged if
  16. available, but it can also be used for national-level modeling. Meridian
  17. provides clear insights and visualizations to inform business decisions around
  18. marketing budget and planning. Additionally, Meridian provides methodologies to
  19. support calibration of MMM with experiments and other prior information, and to
  20. optimize target ad frequency by utilizing reach and frequency data.
  21. If you are using LightweightMMM, see the
  22. [migration guide](https://developers.google.com/meridian/docs/migrate) to help
  23. you understand the differences between these MMM projects.
  24. ## Install Meridian
  25. Python 3.11-3.13 is required to use Meridian. We also recommend using a
  26. minimum of 1 GPU.
  27. Note: This project has been tested on T4 GPU using 16 GB of RAM.
  28. To install Meridian, run the following command to automatically install the
  29. latest release from PyPI.
  30. * For Linux-GPU users:
  31. Note: CUDA toolchain and a compatible GPU device is necessary for
  32. `[and-cuda]` extra to activate.
  33. ```sh
  34. $ pip install --upgrade google-meridian[and-cuda]
  35. ```
  36. * For macOS and general CPU users:
  37. Note: There is no official GPU support for macOS.
  38. ```sh
  39. $ pip install --upgrade google-meridian
  40. ```
  41. Alternatively, run the following command to install the most recent, unreleased
  42. version from GitHub.
  43. * For GPU users:
  44. ```sh
  45. $ pip install --upgrade "google-meridian[and-cuda] @ git+https://github.com/google/meridian.git"
  46. ```
  47. * For CPU users:
  48. ```sh
  49. $ pip install --upgrade git+https://github.com/google/meridian.git
  50. ```
  51. We recommend to install Meridian in a fresh
  52. [virtual environment](https://packaging.python.org/en/latest/guides/installing-using-pip-and-virtual-environments/#create-and-use-virtual-environments)
  53. to make sure that correct versions of all the dependencies are installed, as
  54. defined in [pyproject.toml](https://github.com/google/meridian/blob/main/pyproject.toml).
  55. ## How to use the Meridian library
  56. To get started with Meridian, you can run the code programmatically using sample
  57. data with the [Getting Started Colab][3].
  58. The Meridian model uses a holistic MCMC sampling approach called
  59. [No U Turn Sampler (NUTS)](https://www.tensorflow.org/probability/api_docs/python/tfp/experimental/mcmc/NoUTurnSampler)
  60. which can be compute intensive. To help with this, GPU support has been
  61. developed across the library (out-of-the-box) using tensors. We recommend
  62. running your Meridian model on GPUs to get real time optimization results and
  63. significantly reduce training time.
  64. ## Meridian Documentation & Tutorials
  65. The following documentation, colab, and video resources will help you get
  66. started quickly with using Meridian:
  67. | Resource | Description |
  68. | --------------------------- | ---------------------------------------------- |
  69. | [Meridian documentation][1] | Main landing page for Meridian documentation. |
  70. | [Meridian basics][2] | Learn about Meridian features, methodologies, and the model math. |
  71. | [Getting started colab][3] | Install and quickly learn how to use Meridian with this colab tutorial using sample data. |
  72. | [User guide][4] | A detailed walk-through of how to use Meridian and generating visualizations using your own data. |
  73. | [Pre-modeling][5] | Prepare and analyze your data before modeling. |
  74. | [Modeling][6] | Modeling guidance for model refinement and edge cases. |
  75. | [Post-modeling][7] | Post-modeling guidance for model fit, visualizations, optimizations, refreshing the model, and debugging. |
  76. | [Scenario planning][8] | Plan budget allocation with Meridian on Colab & Data Studio interactively. |
  77. | [Migrate from LMMM][9] | Learn about the differences between Meridian and LightweightMMM as you consider migrating. |
  78. | [Full-funnel colab][10] | Learn how to build a full-funnel MMM with intermediate mediator variables. |
  79. | [API Reference][11] | API reference documentation for the Meridian package. |
  80. | [Reference list][12] | White papers and other referenced material. |
  81. [1]: https://developers.google.com/meridian
  82. [2]: https://developers.google.com/meridian/docs/basics/meridian-introduction
  83. [3]: https://developers.google.com/meridian/notebook/meridian-getting-started
  84. [4]: https://developers.google.com/meridian/docs/user-guide/installing
  85. [5]: https://developers.google.com/meridian/docs/pre-modeling/collect-data
  86. [6]: https://developers.google.com/meridian/docs/advanced-modeling/control-variables
  87. [7]: https://developers.google.com/meridian/docs/post-modeling/model-fit
  88. [8]: https://developers.google.com/meridian/docs/scenario-planning/meridian-scenario-planner
  89. [9]: https://developers.google.com/meridian/docs/migrate
  90. [10]: https://developers.google.com/meridian/notebook/meridian-full-funnel
  91. [11]: https://developers.google.com/meridian/reference/api/meridian
  92. [12]: https://developers.google.com/meridian/docs/reference-list
  93. ## Support
  94. **Questions about methodology**: Please see the [Modeling](https://developers.google.com/meridian/docs/basics/meridian-introduction) tab in the technical documentation.
  95. **Issues installing or using Meridian**: Feel free to post questions in the
  96. [Discussions](https://github.com/google/meridian/discussions) or [Issues](https://github.com/google/meridian/issues) tabs of the Meridian GitHub repository. The Meridian team responds to
  97. these questions weekly in batches, so please be patient and don't reach out
  98. directly to your Google Account teams.
  99. **Bug reports**: Please post bug reports to the [Issues](https://github.com/google/meridian/issues)
  100. tab of the Meridian GitHub repository. We also encourage the community to share
  101. tips and advice with each other on the [Issues](https://github.com/google/meridian/issues)
  102. tab. When our team addresses or resolves a new bug, we will notify you through
  103. the comments on the issue.
  104. **Feature requests**: Please post these to the [Discussions](https://github.com/google/meridian/discussions)
  105. tab of the Meridian GitHub repository. We have an internal roadmap for Meridian
  106. development, but would love your inputs for new feature requests so that we can
  107. prioritize them based on the roadmap.
  108. **Pull requests**: These are appreciated but are very difficult for us to merge
  109. because the code in this repository is linked to Google internal systems and has
  110. to pass internal review. If you submit a pull request and we believe that we can
  111. incorporate a change in the base code, we will reach out to you directly about
  112. this.
  113. ## Citing Meridian
  114. To cite this repository:
  115. <!-- mdlint off(SNIPPET_INVALID_LANGUAGE) -->
  116. ```BibTeX
  117. @software{meridian_github,
  118. author = {Google Meridian Marketing Mix Modeling Team},
  119. title = {Meridian: Marketing Mix Modeling},
  120. url = {https://github.com/google/meridian},
  121. version = {2.2.0},
  122. year = {2026},
  123. }
  124. ```

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.