Pkgly

Appearance

Python Repository ​

Pkgly provides a simple Python artifact store for wheels and source distributions.

Uploading Packages ​

  • Authenticate with an account that has Write permissions for the repository.
  • Upload to /repositories/<storage>/<repository>/<package>/<version>/<filename> using PUT or POST.
  • Pkgly records metadata (package name, version, and filename) for search and project pages.

Downloading Packages ​

Published files are available under the same path used when uploading. Any authenticated or public client with read access can fetch the artifacts directly.

Proxy Mode ​

  • Switch the repository configuration to Proxy and add one or more upstream URLs (for example https://pypi.org). Pkgly appends the request path automatically, so you do not need the /simple suffix in the upstream.
  • Pkgly will fetch packages on demand. Binary artifacts are cached locally on first request; directory-style HTML responses are streamed directly from upstream.
  • Package links in upstream indexes point back to the proxy repository.
  • If the repository is private, readers still need permission—Pkgly only reaches out to the upstream after the local permission check succeeds.

Virtual Mode ​

Virtual Python repositories let you combine multiple hosted/proxy Python repositories behind a single /simple/ endpoint.

See: repositoryTypes/python/virtual/.

Metadata ​

Package metadata is stored in project_versions.extra as a PythonPackageMetadata object, making it available to the user interface and APIs for downstream consumption.

Usage with uv ​

How to exercise with uv:

  1. Hosted upload – configure a hosted Python repo, create a user with write access, then publish from a project directory:
uv publish --index-url https://<host>/repositories/<storage>/<repo> \
            --username <pkgly_user> --password <pkgly_password>
  1. Hosted download – install a specific wheel from Pkgly directly:
uv pip install https://<host>/repositories/<storage>/<repo>/<package>/<version>/<filename>

replace <filename> with the actual wheel or sdist you uploaded

  1. Proxy download – flip the repo to Proxy mode with an upstream such as https://pypi.org, then:
uv pip install --index-url https://<host>/repositories/<storage>/<repo>/simple <package>

Pkgly will fetch from PyPI on first access and cache locally.

  1. Proxy verification – repeat the install (step 3) and observe that the second run is served from Pkgly without contacting the upstream.

For hosted NPM repos, the proxy/hosted flows follow the same pattern via the updated Vue config screen.