What problem does it solve?
Provides a practical, repeatable workflow to make Python utilities self-contained, reproducible, and easy to distribute by using uv's PEP 723 inline metadata. It eliminates scattered requirements files, reduces environment drift, and helps teams convert ad-hoc scripts or bash automation into validated, dependency-managed single-file Python scripts.
Core Features & Use Cases
- Script conversion: Tools and templates to convert existing Python or requirements-based scripts into PEP 723 uv single-file scripts.
- Validation & safety: Validators that check PEP 723 metadata, shebang correctness, and common security anti-patterns before deployment.
- Templates & patterns: Ready-made templates for CLI apps, API clients, data processors, and production-ready examples with CI guidance.
- CI/CD and team adoption: Guidance and workflow examples for integrating uv scripts into GitHub Actions or GitLab CI and establishing team standards.
Quick Start
Run the tools/convert_to_uv.py script on your script to add PEP 723 inline metadata and produce an executable uv single-file.