Flags

This page lists the different flags/env vars you can pass to RAITAP.

Each row gives the equivalent surface across the CLI, the Python API (raitap.run(...) kwargs), and the environment. The accepted truthy value for every env var is the literal string "1"; any other value (including unset) is no consent.

Hydra's own flags (--config-name, --config-dir, --multirun, --help, --hydra-help) are not listed here, see Some advanced Hydra features.

General CLI flags

CLI	Python API	Env var	Description
--demo	—	—	Run the bundled demo config. Equivalent to --config-name demo against the packaged raitap.configs directory.
--version / -V	raitap.__version__	—	Print the installed RAITAP version and exit. Short-circuits before deps inference.

Dependency-management flags

CLI	Python API	Env var	Description
--dry-run	—	—	Print the inferred extras for the composed config and exit without installing or running.
--sync-only	—	—	Install the inferred extras and exit before the pipeline runs.
--custom-deps	auto_install_deps=False (default)	—	Skip dep inference entirely; caller is responsible for installing the right extras.
--allow-project-edit / -y	auto_install_deps=True	—	Consent to uv add mutating pyproject.toml / uv.lock when extras are missing.
--exec-global	exec_global=True	—	Consent to bare-pip install into the active interpreter when no venv is detected. Not recommended.

Safety-consent flags

CLI	Python API	Env var	Description
--allow-preprocessing-exec / -yp	acknowledge_preprocessing_exec=True	RAITAP_ALLOW_PREPROCESSING_EXEC=1	Consent to importing a user-supplied preprocessing .py (runs arbitrary code at load time).
--acknowledge-preprocessing-off	acknowledge_preprocessing_off=True	RAITAP_ACKNOWLEDGE_PREPROCESSING_OFF=1	Acknowledge running with both data.preprocessing and data.model_input_transformation set to null.
--allow-unsafe-pickle	allow_unsafe_pickle=True	RAITAP_ALLOW_UNSAFE_PICKLE=1	Consent to loading legacy checkpoints with torch.load(..., weights_only=False) (runs arbitrary code at load time).

Setting env vars

POSIX shell:

export RAITAP_ALLOW_PREPROCESSING_EXEC=1
uv run raitap --config-name assessment

PowerShell:

$env:RAITAP_ALLOW_PREPROCESSING_EXEC = "1"
uv run raitap --config-name assessment

GitHub Actions:

- run: uv run raitap --config-name assessment
  env:
    RAITAP_ALLOW_PREPROCESSING_EXEC: "1"