python-oneoff

name	python-oneoff
description	Write and run one-off Python scripts with external dependencies using `uv` and PEP 723 inline metadata. Trigger for quick scripts, throwaway automation, API probes, and data checks that need third-party packages.

Python One-Off Scripts

Embed dependencies directly in a script file with PEP 723 metadata.

Inline dependency block

# /// script
# dependencies = ["requests", "pandas>=2.0"]
# requires-python = ">=3.11"
# ///

import requests
import pandas as pd

Useful commands

• uv init --script example.py --python 3.12
• uv add --script example.py 'requests<3'
• uv run script.py
• uv run --python 3.12 script.py
• uv run --with httpx script.py