baseten truss fetches and runs truss with uv tool run, so uv must be installed. It forwards this CLI’s credentials to truss over environment variables, so truss uses the same profile without reading your trussrc.
Pass --truss-executable to run a specific truss binary instead of fetching one (for example .venv/bin/truss). This is required for truss commands that import your own Python code, such as chains push, because uv tool run runs an isolated truss that cannot see your project’s dependencies.
baseten truss no longer runs a truss found on PATH. Install uv (pip install uv or brew install uv) and let baseten truss fetch truss, or point --truss-executable at a truss you installed yourself.truss
Options
TEXT
Run this truss executable instead of fetching one with uv, e.g. a virtualenv’s bin/truss. A value with no path separator is looked up on PATH, so ‘—truss-executable truss’ runs the truss you installed. Defaults to BASETEN_TRUSS_EXECUTABLE.
BOOL
Do not forward this CLI’s credentials to truss, leaving it to resolve a remote from your trussrc. Old truss versions ignore forwarded credentials and use the trussrc regardless.
TEXT
Version of truss to fetch and run with ‘uv tool run’, e.g. 0.18.26. Defaults to BASETEN_TRUSS_VERSION, or the latest release. Mutually exclusive with —truss-executable.
Examples
Show truss help by passing--help to truss
Output
Text mode (--output text): Whatever the truss CLI writes to stdout/stderr, passed through verbatim. --output and --jq are not honored: all arguments after truss are forwarded to the underlying truss binary. The exit code is propagated from truss.
JSON mode (--output json): payload type cmd.JSONUndefined.