My Open Scripts

This is a collection of (mainly Python-) scripts that I have written (or modified) for a number of different tasks. I have made them available here in the hope that they may be useful to others.

These scripts are designed to be run from the command line with minimal friction and in multiple environments.

This is why the Python-scripts include special inline script metadata which allow the awesome uv Python package manager to run them instantly - that is, without the need to install any dependencies manually first because uv will take care of that (by installing them very fast in a temporary environment). (Inspired by Simon Willison's blog post)

How To Use

Python scripts

1. Install uv by following their Instructions
2. Run the script:

# a) running a script directly (from this repository, without downloading it first)
uv run https://raw.githubusercontent.com/simon-ami/MOS/main/<path-to-script> <args>

# b) running a script after downloading it
uv run <path-to-script> <args>

# c) or using pip
pip install <dependencies-in-frontmatter>
python <path-to-script> <args>

Replace <path-to-script> with the path to the script you want to run, and <args> with the arguments you want to pass to the script.

Example:

Running the Audio Converter:

uv run https://raw.githubusercontent.com/simon-ami/MOS/main/ConvertAudioToMp3/mp3.py input_folder -o output_folder

Using uvrun

uv tool install uvrun
uvrun -a https://github.com/simon-ami/MOS
uvrun mp3 input_folder -o output_folder
uvrun llmskill https://docs.anthropic.com/llms.txt
uvrun mp3 -- --help

Use -- --help to show a script's help through uvrun. uvrun --help shows uvrun's own help. Script help uses stable filenames such as mp3.py. Launch the script with uvrun mp3, uv run mp3.py, or python mp3.py with its dependencies installed.