uv - Python Package & Project Manager

All documentation files are flat, numbered markdown files. Use the Read tool to load referenced files identified as relevant for full details.

Command-to-Document Quick Reference

Document Index

Cross-Reference by Scenario

Key Environment Variables

Key Configuration Snippets

pyproject.toml [tool.uv] settings

Full details: 03-project-config.md, 10-configuration.md

[tool.uv]
dev-dependencies = ["pytest>=8.0", "ruff>=0.5"]
python-preference = "managed"       # prefer uv-managed Python
package = false                     # treat as non-package (app)
default-groups = ["dev"]            # groups installed by default

[[tool.uv.index]]
name = "custom"
url = "https://custom.pypi.org/simple"
explicit = true                     # only use for packages that request it

[tool.uv.sources]
my-pkg = { git = "https://github.com/org/repo", tag = "v1.0" }

Workspace configuration

Full details: 12-workspaces.md

[tool.uv.workspace]
members = ["packages/*"]
exclude = ["packages/experimental"]

Dependency overrides and constraints

Full details: 05-resolution.md, 04-dependencies.md

[tool.uv]
override-dependencies = ["package==1.0.0"]
constraint-dependencies = ["package>=1.0,<2.0"]

Index configuration with authentication

Full details: 10-configuration.md, 11-authentication.md

[[tool.uv.index]]
name = "private"
url = "https://private.pypi.org/simple"

export UV_INDEX_PRIVATE_USERNAME=user
export UV_INDEX_PRIVATE_PASSWORD=token

Instructions for the Agent

1. •Identify the topic from the user's question using the Command Reference or Cross-Reference tables above.
2. •Read the primary doc listed for that topic. All files are at ./<filename> relative to this SKILL.md.
3. •Read secondary docs from the "Also see" column or Cross-Reference table if the primary doc doesn't fully answer the question.
4. •Each file is self-contained per topic - you typically need only 1-2 files per question.
5. •When generating pyproject.toml configuration, cross-check with 03-project-config.md and 10-configuration.md.
6. •When suggesting commands, verify flags and options against the relevant doc before recommending them.
7. •For integration-specific questions (FastAPI, Jupyter, PyTorch, etc.), check 15-integrations.md first - each integration has its own ## section.