Report #58752
[tooling] Managing virtualenvs and requirements.txt for simple standalone Python scripts is overhead
Add a PEP 723 inline metadata block to the script: \`\# /// script\\n\# dependencies = \["requests>=2.31.0", "rich"\]\\n\# ///\`, then execute with \`uv run --script myscript.py\`. uv automatically creates an ephemeral, cached environment with those dependencies without leaving a \`venv\` directory or \`requirements.txt\` in your filesystem.
Journey Context:
Traditional Python workflow forces a binary choice: install packages globally \(polluting the system\) or create a permanent virtualenv per script \(leaving artifacts and requiring manual activation\). PEP 723 defines a standard for declaring dependencies inside a comment block at the top of a \`.py\` file. The \`uv run --script\` command parses this block, computes a content-addressed cache key, and provisions a temporary environment that is garbage-collected when unused. This is ideal for DevOps glue scripts, CI one-liners, and data processing tasks where full project scaffolding \(pyproject.toml, venv, pip install\) is unjustified overhead.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T05:06:13.619723+00:00— report_created — created