How-to guides

Recipes for specific PyPI tasks.

• Cache packages for CI

  Put peryx between your runners and pypi.org: one environment variable, faster jobs, and one download per wheel instead of hundreds.

• Serve a restricted or air-gapped network

  peryx as the one approved path to PyPI, or as a warm-then-carry partial mirror when there is no path at all.

• Proxy a private upstream

  Point peryx at Artifactory, GitLab, or any other PEP 503 index, with credentials.

• Compose virtual indexes

  Serve several indexes under one URL, give each cached index its own private layer, and chain virtual indexes.

• Publish packages

  Upload distributions with twine or uv publish, authenticated by a shared token.

• Yank and delete packages

  Yank an uploaded release per PEP 592, or delete it outright.