Python scripts with uv

March 09, 2025

Ensure that you have uv installed.

Create a script, and require a minimum Python version. uv should manage Python versions and dependencies for you in the background, so I don't see why not to just use the latest Python version.

uv init --script my_script.py --python 3.13.2

Update the shebang line, and make the script executable:

sed -i '1i\#!/usr/bin/env -S uv run --script' my_script.py
chmod u+x my_script.py

Test it

./my_script.py

Hello from my_script.py!

Add dependencies to the script:

uv add --script my_script.py 'requests'

More detailed documentation on the official website.