single-file-uv-scripter

Self-contained Python scripts embed inline dependencies using a PEP 723-style metadata header. When you run the script with uv run, it automatically installs those dependencies and executes without requiring separate environment setup or manual package management.

PEP 723 defines a standard format for embedding script metadata, including dependencies, directly in Python files. It enables zero-config execution by letting tools like uv read and install dependencies from the script itself, eliminating external configuration files.

Yes. uv run executes Python scripts that declare inline dependencies via a PEP 723 metadata block. It automatically installs the specified dependencies on first run and handles all package management, making scripts portable across environments.

Package your Python script as self-contained by adding a PEP 723 metadata header with inline dependencies and an optional requires-python directive. Users run it with uv run, which auto-installs dependencies and executes the script without manual setup, ensuring portability.

Inline dependencies require uv to be available on the target system and work best for small CLI tools and automation tasks. Complex projects with many dependencies or custom build steps are better served by traditional package management and virtual environments.

You can optionally declare a requires-python directive in the PEP 723 metadata block to specify version constraints. uv respects this requirement during execution, ensuring the script runs only on compatible Python versions.