Use Python with uv

Use uv exclusively. Never use pip, pip3, pip-tools, poetry, virtualenv or conda for dependency management.

Use uv run <script>.py instead of python <script>.py.

Use one-off code instead of python -c "code".

uv run - <<'EOF'
<script>
EOF

Project (has pyproject.toml or requirements.txt)

• Init new project: uv init
• Add dep: uv add <package>
• Remove dep: uv remove <package>
• Sync env: uv sync
• Run script: uv run <script>.py

Standalone Script (outside a project, or temporary use but need keep the file)

Use PEP 723 inline metadata to declare dependencies inside the script:

# /// script
# requires-python = ">=3.12"
# dependencies = [
#     "requests",
# ]
# ///

• Or add dep: uv add <package> --script <script>.py
• Or remove dep: uv remove <package> --script <script>.py
• Run: uv run <script>.py

One-Off Code (no file saved, temporary execution)

uv run - <<'EOF'
<script>
EOF

Other Commands

• Run a tool temporarily: uvx <tool>
• Install a tool globally: uv tool install <tool>
• Run with specific Python version: uv run --python 3.10 .py