On the recordRead 11 Oct 202618 facts
clvkit
On the record
- CLV and cohorts
- The library composes purchase and spend models to estimate discounted lifetime value and provides cohort retention, revenue, and survival analysis.github.com · read 4 Oct 2026
- Cohort analysis
- CohortMatrix produces retention or revenue cohort tables and heatmaps, while CohortSurvival estimates survival by acquisition cohort.github.com · read 11 Oct 2026
- Core models
- Its models include BG/NBD, MBG/NBD for customers who may never return after their first purchase, and Gamma-Gamma for spend per transaction.github.com · read 4 Oct 2026
- Customer predictions
- Its pipeline predicts expected purchases, expected spend, and discounted customer lifetime value.github.com · read 11 Oct 2026
- Dependencies
- The project lists numpy, scipy, pandas, and matplotlib as its four runtime dependencies, with Dask available as an optional extra for summarizing large logs.github.com · read 4 Oct 2026
- Input and output
- It accepts transaction logs with customer ID, date, and amount, and prediction results can be converted to pandas DataFrames or JSON and plotted.github.com · read 4 Oct 2026
- Install requirements
- The package installs with pip or uv, requires Python 3.11 or later, and has four runtime dependencies: numpy, scipy, pandas, and matplotlib.github.com · read 11 Oct 2026
- Intended users
- The README describes it as a narrower tool for analysts who want model parameters and a CSV through a maximum-likelihood workflow.github.com · read 11 Oct 2026
- Large logs
- An optional Dask extra supports transaction-log summarization, with the README reporting a performance crossover at about 4 million transactions.github.com · read 11 Oct 2026
- License
- The package metadata identifies its license as BSD-3-Clause.github.com · read 11 Oct 2026
- Limits
- The project says it does not include covariates, Bayesian fitting, or additional model families.github.com · read 11 Oct 2026
- Maintainer
- The README says the author is building customer-analytics work on top of clvkit and intends the library to remain installable and correct.github.com · read 4 Oct 2026
- Models
- The model roster is BG/NBD, MBG/NBD, and Gamma-Gamma, with CLV composing transaction and spend models.github.com · read 11 Oct 2026
- Outputs
- Prediction results can be converted to pandas or JSON and plotted.github.com · read 11 Oct 2026
- Purpose
- clvkit is a Python library for estimating customer lifetime value and cohort retention from transaction logs for non-contractual businesses.github.com · read 11 Oct 2026
- Python requirements
- Installation is available with uv or pip and requires Python 3.11 or later.github.com · read 4 Oct 2026
- Support
- The project links to its GitHub Issues page for issue reporting.github.com · read 11 Oct 2026
- Validation
- CI checks reproduced published BG/NBD and Gamma-Gamma estimates on the CDNOW sample on pushes, pull requests, and before releases.github.com · read 11 Oct 2026