`uvx`

Executes Python CLI tools and scripts in ephemeral, isolated virtual environments without permanently installing them to the system. uvx downloads the tool's package, creates a temporary venv, installs dependencies, runs the tool, and cleans up—all in a single command. This approach uses temporary directory management and automatic cleanup to prevent dependency pollution and version conflicts on the host system.

Allows specifying exact tool versions or version constraints at invocation time using syntax like `uvx package==1.2.3` or `uvx package@>=1.0,<2.0`. The tool resolves the requested version from PyPI, downloads it into the isolated environment, and executes it—enabling reproducible tool runs without modifying global configuration or lock files.

Executes standalone Python scripts that declare their dependencies inline (via PEP 723 script metadata or similar mechanisms) without requiring separate requirements files or environment setup. uvx parses the script's dependency declarations, creates an isolated environment with those dependencies, and runs the script—enabling self-contained, shareable Python scripts that work across machines.

When executing tools with dependencies, uvx resolves the complete dependency graph, detects version conflicts between tool requirements, and either resolves them automatically or reports conflicts to the user. This uses uv's fast PubGrub-based resolver to compute compatible versions across all transitive dependencies, preventing runtime failures from incompatible package versions.

Maintains a local cache of downloaded packages and resolved dependency graphs, reusing them across multiple uvx invocations to avoid redundant network requests and resolution work. When the same tool or version is requested again, uvx retrieves it from cache instead of re-downloading, dramatically reducing startup time for repeated tool executions.

Transparently forwards environment variables and stdin streams from the parent process to the isolated tool environment, enabling tools to access secrets, configuration, and input data without modification. uvx preserves the parent's environment context while maintaining isolation of the tool's dependencies, allowing seamless integration with existing shell scripts and CI/CD pipelines.

Captures and preserves the exit code from the executed tool, propagating it to the parent process to enable proper error handling in shell scripts and CI/CD pipelines. uvx also reports detailed error messages for its own failures (e.g., dependency resolution errors, network failures) separately from tool errors, allowing callers to distinguish between tool failures and uvx infrastructure failures.