loaderup 0.1.0

Lightweight load-testing API and CLI built around FastAPI, k6, and decorator-based target registration.

LoaderUp

Lightweight load-testing API and CLI built around FastAPI, k6, and decorator-based target registration.

Requirements

• Python >=3.12
• uv (recommended package manager)
• k6 (optional but recommended for real load runs)

Install

uv pip install -e .

Run API directly

python -m loader.main

Server starts on http://127.0.0.1:8000 by default.

Run via CLI

python -m loaderup.cli up --app loader.main:app --targets loader.demo_registry_target --reload

This command opens the dashboard automatically at http://127.0.0.1:8000/. Use --no-open-browser if you want to disable auto-open.

You can also use fallback-friendly forms like:

python -m loaderup.cli up --app main:app --targets demo_registry_targets --reload

Health check

curl http://127.0.0.1:8000/health

Dashboard

Open:

http://127.0.0.1:8000/

Dashboard includes:

• live status + progress stream
• metrics cards + quick chart bars
• saved run history (persisted in artifacts/history/runs.jsonl)
• React-based multi-tab control center (Run Now, Live, Registered Targets, History)

Notes

• Registry targets are loaded when the module is imported.
• Use /run/targets to submit explicit targets.
• Use /run/registry to run all decorator-registered targets.