Skip to main content
Once authenticated, you can install from pyx by configuring an index URL. For example, to install FastAPI from the PyPI proxy, run:
uv pip install fastapi --index https://api.pyx.dev/simple/pypi
Or, configure the index in your pyproject.toml:
[[tool.uv.index]]
name = "pypi"
url = "https://api.pyx.dev/simple/pypi"
Similarly, to use the CUDA 12.6-enabled index, use the corresponding index URL:
[[tool.uv.index]]
name = "cu126"
url = "https://api.pyx.dev/simple/astral-sh/cu126"
By default, users have access to the following indexes:
  • public/pypi
  • astral-sh/cpu
  • astral-sh/cu118
  • astral-sh/cu121
  • astral-sh/cu124
  • astral-sh/cu126
  • astral-sh/cu128
  • astral-sh/cu129
  • astral-sh/rocm6.0
  • astral-sh/rocm6.1
  • astral-sh/rocm6.2
  • astral-sh/rocm6.2.4
  • astral-sh/xpu
Along with an internal index for your team’s packages (e.g., acme/main).

pip support

pyx supports installing packages with non-uv clients, like pip. To use pyx with pip, we recommend installing the pyx-keyring package, which leverages pip’s keyring support to authenticate requests to pyx. Specifically, to authenticate pip, install the pyx-keyring package into the virtual environment, then set pip’s index URL to the appropriate pyx index:
# Create a virtual environment.
python -m venv .venv
source .venv/bin/activate

# Install keyring and the pyx-keyring plugin.
pip install keyring pyx-keyring

# Install from pyx.
pip install fastapi --index-url https://api.pyx.dev/simple/pypi
pyx-keyring will authenticate requests via the PYX_API_KEY or PYX_AUTH_TOKEN environment variables, if set; otherwise, it will use the uv client to authenticate by invoking uv auth token pyx.dev.
If you’re using pip in a headless context (e.g., a Databricks notebook), you’ll need to set pip’s keyring-provider to import explicitly, as the default provider (auto) will disable keyring in these settings.You can configure pip to use the import provider by passing --keyring-provider=import to the pip install command, setting the PIP_KEYRING_PROVIDER=import environment variable, or running pip config set --global global.keyring-provider import.
I