A transparent leveraged buyout (LBO) model in Python. Work in progress: the model is being added step by step through pull requests. This README describes only what exists on this branch; the full documentation (method, example output, limitations) arrives with the documentation pull request.
What exists on this branch:
- project skeleton: a uv project (
pyproject.toml,uv.lock, Python 3.11+), the packagelbowith its version number, MIT license - CI on GitHub Actions for Python 3.11 and 3.12: ruff lint, ruff format check, pytest
- one smoke test that the package can be imported
Planned, in integration order:
- validated YAML deal assumptions and the core LBO engine: sources & uses, operating projection, cash flow waterfall and debt schedule with cash sweep, exit returns (IRR, MOIC), value creation bridge, entry x exit multiple sensitivity
- formatted Excel workbook export
- command line interface (
python -m lbo run config/example.yaml) - full README with method, example output, example workbook and limitations
- review fixes: limited liability in wiped-out deals, bridge percentages, sweep convention, golden regression test
- input validation and IRR solver hardening
Requires uv and Python 3.11+.
uv sync
uv run ruff check . && uv run ruff format --check .
uv run pytest -qMIT © 2026 Robin-Philip Rehschuh