clvkit

Spec sheet

Purpose

clvkit is a Python library for estimating customer lifetime value and cohort retention from transaction logs for non-contractual businesses.Read 11 Oct 2026 · github.com

Intended users

The README describes it as a narrower tool for analysts who want model parameters and a CSV through a maximum-likelihood workflow.Read 11 Oct 2026 · github.com

Support

The project links to its GitHub Issues page for issue reporting.Read 11 Oct 2026 · github.com

License

The package metadata identifies its license as BSD-3-Clause.Read 11 Oct 2026 · github.com

CLV and cohorts

The library composes purchase and spend models to estimate discounted lifetime value and provides cohort retention, revenue, and survival analysis.Read 4 Oct 2026 · github.com

Cohort analysis

CohortMatrix produces retention or revenue cohort tables and heatmaps, while CohortSurvival estimates survival by acquisition cohort.Read 11 Oct 2026 · github.com

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.Read 4 Oct 2026 · github.com

Customer predictions

Its pipeline predicts expected purchases, expected spend, and discounted customer lifetime value.Read 11 Oct 2026 · github.com

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.Read 4 Oct 2026 · github.com

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.Read 4 Oct 2026 · github.com

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.Read 11 Oct 2026 · github.com

Large logs

An optional Dask extra supports transaction-log summarization, with the README reporting a performance crossover at about 4 million transactions.Read 11 Oct 2026 · github.com

Limits

The project says it does not include covariates, Bayesian fitting, or additional model families.Read 11 Oct 2026 · github.com

Maintainer

The README says the author is building customer-analytics work on top of clvkit and intends the library to remain installable and correct.Read 4 Oct 2026 · github.com

Models

The model roster is BG/NBD, MBG/NBD, and Gamma-Gamma, with CLV composing transaction and spend models.Read 11 Oct 2026 · github.com

Outputs

Prediction results can be converted to pandas or JSON and plotted.Read 11 Oct 2026 · github.com

Python requirements

Installation is available with uv or pip and requires Python 3.11 or later.Read 4 Oct 2026 · github.com

Validation

CI checks reproduced published BG/NBD and Gamma-Gamma estimates on the CDNOW sample on pushes, pull requests, and before releases.Read 11 Oct 2026 · github.com

Where Specifiction places it

• Customer Lifetime Value Software#30 of 377.1