mauth-reloaded

A complete rewrite of my research project from college, utilizing a modern toolchain, dependencies, and practices.

Requirements

• uv for dependency management
• Python 3.14 (installed automatically by uv)

Setup

uv sync --group dev

CLI

# preprocess raw CSVs into per-subject feature Parquet files
uv run mauth preprocess --in data/raw --out data/features --seq-len 128

# train models against a combined feature file
uv run mauth train --models knn,dt,svc --feature-file data/features/all.parquet

# plot ROC curve from a results file
uv run mauth plot roc --results results/run.json

Development

Run the full CI check suite locally:

uv run ruff check src tests       # lint
uv run ruff format src tests      # format (drop --check to apply)
uv run mypy src                   # type check
uv run pytest                     # tests + coverage

All four must be clean before opening a PR. The Forgejo CI workflow (.forgejo/workflows/ci.yml) runs the same commands on every push.