rundir

Super minimal run directory manager for experiments. Auto-numbered run folders + JSON config dump. No deps.

Install

pip install rundir
# or
uv add rundir

Quickstart

from rundir import Run

run = Run("train", base_output_dir="out")
run.add(lr=1e-3, batch_size=32, model="resnet50")

# writes:
#   out/train/train-1/config.json

Re-running increments the suffix: train-2, train-3, ...

Access run info

run.run_dir   # Path("out/train/train-3")
run.id        # 3
run.config    # {"lr": 1e-3, "batch_size": 32, "model": "resnet50"}

Param wrapper

Auto-registers named params with active run.

from rundir import Param

lr = Param(1e-3, name="lr")
print(lr)  # 0.001

License

MIT