SuperAPI AI Directory

uv

Coding & development

View repository

Updated 11-04 18:33

About this skill

uv

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.

  1. Find the category corresponding to the task in the mapping table below
  2. Refer to that category's references/{category}/README.md to identify the target page
  3. Read the relevant page's .md to check the details
  4. For typical usage, consult samples/README.md; for execution commands, consult scripts/README.md subtract

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