Python Script with uv

Template

#!/usr/bin/env -S uv run --quiet --script
# /// script
# requires-python = ">=3.11"
# dependencies = ["dep1", "dep2"]
# ///
"""Brief description."""

import argparse


def main():
    parser = argparse.ArgumentParser(description="Description")
    # args...
    args = parser.parse_args()
    # implementation...


if __name__ == "__main__":
    main()

Rules

• Shebang: #!/usr/bin/env -S uv run --quiet --script
• PEP 723 block with requires-python and dependencies
• Only list external dependencies (not stdlib)
• Use argparse for CLI
• Always use if __name__ == "__main__": main()