Tutorials

Step-by-step lessons that take PyPI use from zero to a working setup.

• Getting started

  Serve Python packages through peryx: cache pypi.org, install with pip and uv, publish a private package, then yank and delete it.

• Build a team index

  Design a topology in TOML: separate team indexes, one shared cache, and private packages that shadow PyPI.

• Front another index

  Mirror an index that is not pypi.org, watch peryx upgrade its protocols, and layer it with PyPI under one URL.

• Publish and manage a release

  Upload a historical wheel and an MD5-only wheel, yank a release by an equivalent PEP 440 version, and delete a project named after a mutation verb, watching peryx take the same inputs pypi.org does.

• Observe Simple API behavior

  Watch peryx derive the advertised api-version from two upstreams, drop the gpg-sig marker on a file it content-addresses while keeping it on a pass-through, and redirect a slashless Simple URL to its canonical form.