Run Python scripts with inline metadata directly from URLs. This simple tool integrates with uv to provide a seamless experience for running Python scripts from GitHub repositories.

• Run Python scripts directly from GitHub repositories
• Manage multiple script repositories
• Smart script discovery with inline metadata
• Pass arguments directly to scripts and uv
• List available scripts with a nice directory structure

pip install uvrun

Add a repository:

uvrun --add https://github.com/username/repo

List available scripts:

uvrun --list

Run a script:

uvrun script_name arg1 arg2

(Note: both script_name and script_name.py are valid)

With specific Python version:

uvrun script_name --uv-args "--refresh"

To make a script discoverable by uvrun, add the following inline metadata at the top of the file:

# /// script
# requires-python = ">=3.12"
# dependencies = [
#     "flask>=2.0.0",
#     "requests>=2.31.0",
# ]
# ///

MIT License