Allow installation of scripts, e.g., uv tool install --script <path> or uv script install

[shoucandanghehe]

I often write small standalone python scripts and I'll use them anywhere.

If using uv run /path/to/script.py is a bit cumbersome for me (mostly typing the path)
So I want a uv script command to globally install these scripts

Maybe something like uv tool, but uv script manages scripts, uv tool manages tools.

Related: pypa/pipx#1388 (although pipx doesn't implement it too)

[nikhilweee]

Is this related to #5903? Or do you specifically want uv to install scripts globally?

[shoucandanghehe]

Is this related to 5903? Or do you specifically want uv to install scripts globally?

It's not quite the same, 5903 is a project-level command alias, something like npm run xxx
Whereas what I want is to make a single-file script available globally, like uv tool does for packages

[zanieb]

I guess we could support something like uv tool install ./script.py 🤔

[kj-9]

I'm also looking forward to this feature.

In the meantime, I created a template that generates the minimum required files for uv tool install as a temporary solution:
https://github.com/kj-9/uv-tool-min-copier

[Werni2A]

Now that a lot of the inline script meta-data (PEP 723) functionality has been merged, something like uv tool install --script ./script.py would complement the other CLI commands.

[zanieb]

I'm in favor of this, but I think we'll need to figure out what the design looks like.

[zachvalenta]

some recent examples that might be relevant here:

• https://akrabat.com/using-uv-as-your-shebang-line/
• https://aider.chat/2025/01/15/uv.html

both from a discussion on HN

[alisterburt]

just adding a voice of support here - I tried to achieve this today with the syntax uv tool install ./script.py and was a bit surprised when it didn't work 🙂

I regularly distribute scripts to less tech-savvy users, allowing installation of scripts like this would reduce the cognitive burden of using a script from

• where was that script again?
• how do I run it again?
• uv run /path/to/script.py

to

• $ script.py

To achieve this right now I need to spin up a whole package for the script and add an entry point with the same name as the package

edit: I like the proposed uv script install syntax