uv run

Execute a build inside a uv-managed isolated environment.

Mirrors xorq run, but executes with the build’s packaged sdist so the runtime matches the dependencies recorded at build time.

Usage

xorq uv run BUILD_PATH [OPTIONS]

Arguments

• BUILD_PATH—Path to the build directory produced by xorq uv build.

Options

Option	Default	Description
--cache-dir	$XORQ_CACHE_DIR or ~/.cache/xorq	Directory for parquet cache files.
-o, --output-path	/dev/null (discard)	Path to write output. Use ‘-’ for stdout.
-f, --format	parquet	Output format.
--limit	unlimited	Maximum number of rows to output.
-p, --params	none	Override an expression parameter as key=value (repeatable, for example –params threshold=0.5).

Examples

# Save results to parquet
xorq uv run builds/7061dd65ff3c -o results.parquet
# Stream JSON to stdout
xorq uv run builds/7061dd65ff3c -f json -o -

See also

• run—same semantics, in the current environment
• uv build—produce the packaged build this command executes