ketum

Differentially private reporting for periodic statistics.

Quick Start

docker pull nuriacar/ketum:latest
docker run --rm nuriacar/ketum:latest reproduce

Expected: 52/52 PASS.

Commands

Command	Description
ketum review	Getting started guide for all roles
ketum reproduce	Verify all claims (52 PASS/FAIL checks)
ketum query COUNT -e EPSILON	Anonymize a single count
ketum budget show	Check privacy budget status
ketum budget consume -e 0.36	Consume per-report budget
ketum simulate -n 500 -e 0.5,1.0,2.0,5.0	Utility and adversary resistance
ketum adversary -n 500 -b 4.32	Budget-managed adversary accuracy
ketum compare -e 4.32 -k 12	Mechanism comparison
ketum lambda-sweep -n 500	Lambda sensitivity analysis
ketum anonymize -i FILE	Anonymize incident data (CSV/JSON)
ketum learn	Learn DP concepts (10 topics + story)
ketum usecases	Industry scenarios (10 sectors)

Parameters

Parameter	Default	Description
epsilon_total	4.32	Annual privacy budget
k	12	Reports per year (monthly)
epsilon_per	0.36	Budget per report (4.32 / 12)
delta	1e-5	Gaussian failure probability
sensitivity	1	Max impact of one individual
seed	42	Deterministic reproducibility

Build from Source

docker compose build
docker compose run --rm ketum reproduce

License

AGPL-3.0-or-later. See LICENSE and CLA.md for contribution terms.