Repository navigation
Releases
Releases · yablokolabs/mmm-engine
MMM Engine v0.2.1
Added
mmm fitrefuses channels the data cannot identify: constant spend, or two channels whose weekly spend correlates at r >= 0.98 (--max-correlation). Warns from r >= 0.90; warnings also go tofit.warningsin the model JSON.- macOS Apple Silicon (arm64) release binary; macOS build in CI.
Install
curl -LO https://github.com/yablokolabs/mmm-engine/releases/download/v0.2.1/mmm-v0.2.1-linux-x86_64.tar.gz
tar -xzf mmm-v0.2.1-linux-x86_64.tar.gz
./mmm-v0.2.1-linux-x86_64/mmm helpLinux binaries need glibc 2.38+ (Ubuntu 24.04+, Debian 13+, Fedora 39+). macOS: Apple Silicon. Older systems: use Docker.
Docker: docker run --rm -v "$PWD:/work" ghcr.io/yablokolabs/mmm-engine:0.2.1 help
MMM Engine v0.2.0
Added
mmm fit: learns adstock decay, Hill half-saturation and slope per channel (coordinate grid search), with trend, seasonality and non-negative channel betas by least squares. Scores the last--holdoutweeks on a model that never saw them.mmm optimize: budget reallocation by greedy marginal return plus pairwise exchange, each channel within--boundof current spend. Reports lift and marginal ROI.- CSV input with line-numbered errors.
examples/synthetic: 3 years of data with known answers,run.sh,grade.py.- Test suite (
mmm_tests): known-truth recovery, determinism, optimizer vs brute force, decision quality on the true curves. - CI on every push and pull request; releases (tag push or the "Release" workflow's Run workflow button) ship Linux x86-64 and arm64 binaries and a Docker image on GHCR.
MMM_NATIVECMake option (default ON); release builds turn it off for portable binaries.
Changed
mmm forecastfuture weeks include media driven by a spend plan (--plan), or current spend by default. Previously only trend and seasonality.
Removed
- The placeholder budget optimizer that drifted toward an equal split.
Install
curl -LO https://github.com/yablokolabs/mmm-engine/releases/download/v0.2.0/mmm-v0.2.0-linux-x86_64.tar.gz
tar -xzf mmm-v0.2.0-linux-x86_64.tar.gz
./mmm-v0.2.0-linux-x86_64/mmm helpNeeds glibc 2.38+ (Ubuntu 24.04+, Debian 13+, Fedora 39+). Older systems: use Docker.
Docker: docker run --rm -v "$PWD:/work" ghcr.io/yablokolabs/mmm-engine:0.2.0 help