Reference skill for uv (Astral's fast Python package / project manager).
Target version
uv 0.13.1 (GitHub tag 0.13.1 = commit 62faed3351cfee2121b3c28b937b1f4b93233a93, released 2026-10-14; main is prohibited).
The generated pages (preview listings for reference/cli, reference/settings, reference/environment, and concepts) are not committed to the repository, so they were fetched on 2026-10-16 from the Markdown twins on docs.astral.sh (<path>/index.md). The live installation page distributes install.sh 0.13.1, and we have confirmed that the live site matches the tag.
Directory structure
skills/uv/
SKILL.md
references/
getting-started/
README.md
breaking-changes-0-13.md
features.md
first-steps.md
getting-help.md
installation.md
installer-options.md
platform-support.md
reproducible-examples.md
versioning-policy.md
projects/
README.md
build-editable-virtual-dependencies.md
build-isolation.md
build.md
config.md
conflicts-environments.md
dependencies.md
dependency-groups.md
dependency-sources.md
export.md
init.md
layout.md
lock-sync.md
optional-dependencies.md
run.md
scripts.md
workspace-metadata.md
workspaces.md
project-commands/
README.md
uv.md
uv-add.md
uv-audit.md
uv-check.md
uv-export.md
uv-format.md
uv-init.md
uv-lock.md
uv-remove.md
uv-run.md
uv-sync.md
uv-tree.md
uv-version.md
uv-workspace.md
tools/
README.md
tools.md
uv-tool-audit.md
uv-tool-dir.md
uv-tool-install.md
uv-tool-list.md
uv-tool-run.md
uv-tool-uninstall.md
uv-tool-update-shell.md
uv-tool-upgrade.md
python/
README.md
installing-python.md
managed-distributions.md
python-discovery.md
python-preferences.md
python-support-policy.md
python-variants.md
python-versions.md
uv-python-dir.md
uv-python-find.md
uv-python-install.md
uv-python-list.md
uv-python-pin.md
uv-python-uninstall.md
uv-python-update-shell.md
uv-python-upgrade.md
pip-interface/
README.md
compatibility-options.md
compatibility-resolution.md
declaring-dependencies.md
environments.md
inspection.md
locking-environments.md
packages.md
pip-interface.md
uv-pip-check.md
uv-pip-compile.md
uv-pip-freeze.md
uv-pip-install.md
uv-pip-list.md
uv-pip-show.md
uv-pip-sync.md
uv-pip-tree.md
uv-pip-uninstall.md
uv-venv.md
build-publish/
README.md
build-backend-file-inclusion.md
build-backend-modules.md
build-backend-settings.md
build-backend.md
build-failures.md
uv-build.md
uv-publish.md
resolution/
README.md
conflicting-dependencies.md
constraints-overrides-exclusions.md
dependency-metadata.md
multi-version-resolution.md
platform-markers.md
prereleases.md
reproducible-resolutions.md
resolution-environments.md
resolution-overview.md
resolution-strategy.md
resolver-internals.md
sdist-lockfile-versioning.md
indexes-auth/
README.md
auth-cli.md
authentication.md
certificates.md
flat-indexes.md
git-credentials.md
http-credentials.md
index-authentication.md
indexes.md
third-party-services.md
uv-auth-dir.md
uv-auth-login.md
uv-auth-logout.md
uv-auth-token.md
configuration/
README.md
cache.md
configuration-files.md
environment-variables-external.md
environment-variables-uv-a-m.md
environment-variables-uv-n-z.md
preview-features.md
settings-build-install.md
settings-index-network.md
settings-pip-a-l.md
settings-pip-m-z.md
settings-project-metadata.md
settings-python-misc.md
settings-resolver.md
storage.md
uv-cache.md
uv-self.md
uv-shell-completion-help.md
integrations/
README.md
alternative-registries.md
aws-lambda.md
bazel.md
dependency-bots.md
docker.md
github-actions.md
gitlab-ci.md
jupyter.md
pre-commit.md
pytorch.md
samples/
README.md
build-and-publish.md
coiled.md
docker-multistage.md
fastapi.md
github-actions-workflow.md
inline-script.md
install-python.md
marimo.md
migrate-pip-to-project.md
project-workflow.md
pytorch-cpu-cuda.md
tools-uvx.md
scripts/
README.md
cache.md
install.md
pip-interface.md
project.md
python.md
self-update-uninstall.md
shell-completion.md
tools.md
Exploration procedure
Derive the category from the task, and identify the target page in the category's README.md.
- Find the category corresponding to the task in the mapping table below
- Refer to that category's
references/{category}/README.mdto identify the target page - Read the relevant page's
.mdto check the details - For typical usage, consult
samples/README.md; for execution commands, consultscripts/README.mdsubtract
Task → Category mapping
| Task | Category | Reference README |
|---|---|---|
| Want to know about installing uv, first launch, versioning, and breaking changes in 0.13 | getting-started | references/getting-started/README.md |
| Want to handle project creation, dependencies, dependency groups, workspaces, lock / sync, and PEP 723 scripts | projects | references/projects/README.md |
uv add / uv run / uv sync / uv lock / uv export Want to look up command options such as |
project-commands | references/project-commands/README.md |
uvx / uv tool install Want to run and manage command-line tools with |
tools | references/tools/README.md |
| Want to handle Python installation, discovery, pinning, upgrading, and the free-threaded version | python | references/python/README.md |
uv pip / uv venv Want to use pip- and pip-tools-compatible workflows with |
pip-interface | references/pip-interface/README.md |
uv build / uv publish / uv_build Want to distribute packages with the |
build-publish | references/build-publish/README.md |
| Want to tune resolution strategy, constraints / overrides, platform markers, and exclude-newer | resolution | references/resolution/README.md |
Want to configure external indexes, registry authentication, certificates, anduv auth want to set |
indexes-auth | references/indexes-auth/README.md |
uv.toml / [tool.uv] Want to look upUV_* settings,uv self environment variables, cache, preview features, and |
configuration | references/configuration/README.md |
| Want to combine with Docker / GitHub Actions / GitLab CI / pre-commit / PyTorch / Jupyter / AWS Lambda | integrations | references/integrations/README.md |
| Want to know typical usage | samples | samples/README.md |
| Want to know about installation and CLI commands | scripts | scripts/README.md |