Inspired by:
-
Install via pip (or alternatives):
pip install uvx # or `uv`, `pipx`
-
Optional (for bash users):
uvx setup
This installs the following features:
- Ensures
~/.local/bin/
is added to your PATH, so commands can be found (unless--skip-ensurepath
). Can also be activated viauvx ensurepath
- Enables tab completion for
uvx
(unless--skip-completions
). Can also be enabled viauvx completions --install
. - Enables
uvx activate
(unless--skip-activate
) to activate uvx-managed virtualenvs from your shell
uvx
Run uvx
without any arguments to see all possible subcommands.
-
Rust-Powered Performance (uvx 2.0): Starting from version 2.0,
uvx
leverages Rust for improved performance and compatibility withuv
. - Prebuilt Binaries: Currently, prebuilt binaries are available for x86_64 (amd64) and aarch64 (ARM64) on Linux.
-
Other Platforms: If you're on a different platform, you can still use
uvx 1.x
, which is written in pure Python. Find it at robinvandernoord/uvx. - Alternatively, you can Compile for Your Platform:
- Install the Rust toolchain:
curl https://sh.rustup.rs -sSf | sh
- Clone the
uvx2
repo and navigate to it:git clone https://github.com/robinvandernoord/uvx2.git cd uvx2
- Set up a virtual environment (choose Python or uv):
python -m venv venv # or `uv venv venv --seed` source venv/bin/activate
- Install Maturin (Python with Rust package builder):
pip install maturin # or `uv pip install maturin`
- Compile and install the
uvx
binary:maturin develop
- Now you can use
uvx
:./venv/bin/uvx
- Install the Rust toolchain:
For additional details on building and distribution, refer to maturin documentation.
uvx
is distributed under the terms of the MIT license.
See CHANGELOG.md
on GitHub