single-file-uv-scripter

PEP 723 metadata blocks embedded in Python scripts let you declare dependencies directly in the file header. uv run executes the script, automatically resolving and installing those dependencies without manual environment setup, eliminating configuration overhead.

PEP 723 defines a standard format for embedding dependency metadata in single Python files. It enables zero-config execution: scripts become self-contained and portable, running instantly with `uv run` across different machines without virtual environment management.

Yes. uv run supports PEP 723 metadata blocks in script headers as an alternative to requirements.txt. Declare dependencies, optional Python version constraints, and UV extensions (like exclude-newer and index) directly in the file, and uv handles dependency resolution automatically during execution.

Add a PEP 723 metadata block at the top of your script containing a dependencies array listing required packages. You can also specify requires-python for version constraints and UV extensions. Run `uv run scriptname.py` and uv automatically installs and executes with those dependencies.

CLI applications, HTTP clients, and data processing workflows that fit in a single file benefit most from PEP 723 metadata. These use cases avoid complex package structures, making inline dependencies practical and keeping scripts portable and executable with zero prior setup.