uv-scripts

Self-contained Python scripts declare dependencies directly in the file using PEP 723 inline metadata format. UV automatically isolates the environment and installs packages on demand when you run the script, eliminating the need for separate requirements files or manual setup.

Use UV scripts with inline dependency metadata to bundle everything the script needs in a single file. UV handles environment isolation automatically, so the script runs anywhere UV is installed without requiring virtual environment configuration or dependency pre-installation.

Yes. UV scripts support declaring specific package versions and Python version requirements in inline metadata at the top of your script file. UV creates an isolated environment and installs those exact versions when you execute the script with `uv run` or a shebang-based entry point.

Write a Python script with inline PEP 723 metadata specifying your dependencies, then configure it as a UV script hook. UV automatically manages the isolated environment and package installation when the hook runs, ensuring consistent execution without external dependency management.

No. UV scripts with inline metadata create and manage isolated environments automatically behind the scenes. You run scripts directly with `uv run` or via shebang, and UV handles all environment setup and dependency installation without manual virtual environment creation.

Inline metadata declares dependencies and optional Python version only. Complex workflows requiring multiple interdependent packages, conditional dependencies, or dev-only tools may need a separate pyproject.toml. Single-file scripts prioritize portability and simplicity over advanced dependency management.