How do I install a specific version of a CLI tool with uvx.sh?

Add the version number to the URL path, for example `curl -LsSf uvx.sh/ruff/0.8.3/install.sh | sh`. The same pattern works on Windows by appending the version after the package name in the PowerShell URL. Without a version, uvx.sh installs the latest release from PyPI.

How do I force a reinstall with uvx.sh?

Pass `--force` after `-s --` to the installer script: `curl -LsSf uvx.sh/ruff/install.sh | sh -s -- --force`. This overwrites the existing installation. Use the same `-s -- --index` pattern to install from a private or alternative package index, for example `--index https://download.pytorch.org/whl/cpu`.

How to install Python CLI tools without Python

Q: How do I install a Python CLI tool without having Python installed?

Use uvx.sh, which provides installation scripts for any PyPI package. On macOS or Linux: `curl -LsSf uvx.sh/{package}/install.sh | sh`. On Windows: `powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/{package}/install.ps1 | iex"`. The script downloads uv if needed and installs the requested tool, with no pre-existing Python required.

by Tim Hopper · Markdown

uvx.sh provides installation scripts for any Python tool on PyPI. Use it to install tools like ruff, pre-commit, or pytest without having uv or Python already installed.

Installing a Tool

Replace {package} with any PyPI package name:

curl -LsSf uvx.sh/{package}/install.sh | sh

For example, to install ruff:

curl -LsSf uvx.sh/ruff/install.sh | sh

Replace {package} with any PyPI package name:

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/{package}/install.ps1 | iex"

For example, to install ruff:

powershell -ExecutionPolicy ByPass -c "irm https://uvx.sh/ruff/install.ps1 | iex"

Installing a Specific Version

Add the version number to the URL path:

curl -LsSf uvx.sh/ruff/0.8.3/install.sh | sh

Forcing Reinstallation

To overwrite an existing installation, pass the --force flag:

curl -LsSf uvx.sh/ruff/install.sh | sh -s -- --force

Using a Custom Package Index

To install from a private or alternative package index:

curl -LsSf uvx.sh/cmake/install.sh | sh -s -- --index https://download.pytorch.org/whl/cpu

Learn More

uv: A Complete Guide covers what uv does, how fast it is, the core workflows, and recent releases.
uvx.sh
uvx.sh: Install Python tools without uv or Python
How to install uv

Last updated on June 2, 2026

How to install OpenAI's Astral plugins for Claude Code How to install Python with uv

Please submit corrections and feedback...