ALM

Educational toolkit demonstrating Asset-Liability Management (ALM) concepts for actuarial science students. Built as a personal project for illustrative purposes only — not intended for professional use, financial advice, or production decision-making.

Quick Start

Prerequisites: Python 3.12+ and uv

git clone https://github.com/realslimslaney/ALM.git
cd ALM
uv sync
uv run pytest

New to development? See the Environment Setup guide for step-by-step instructions.

Documentation

• Environment Setup — install VS Code, Git, Python, uv, and Quarto from scratch
• Getting Started — clone the repo, install dependencies, and verify
• Running Scripts — execute scripts with uv run
• Creating Quarto Reports — author and render .qmd reports
• Project Structure — repository layout and conventions

Development

uv run pre-commit install  # install git hooks (once)
uv run ruff check .        # lint
uv run ruff format .       # format
uv run pytest              # test

License

MIT