blumeops/docs/how-to/use-pypi-proxy.md
Erich Blume c130f72204 Update all docs titles to human-readable and delete test cards
Titles now use proper casing (e.g. "Borgmatic" instead of "borgmatic",
"AI Assistance Guide" instead of "ai-assistance-guide") and match file
stems so wiki-links work without alternate anchor text. Also removes
the title-test-alpha/beta cards and their reference index entry.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:40:22 -08:00

1.2 KiB

title tags
Use PyPI Proxy
how-to
python

Use the PyPI Proxy

How to configure clients and publish packages to devpi.

Configure pip/uv

Point pip and uv at the proxy via environment variables:

export PIP_INDEX_URL="https://pypi.ops.eblu.me/root/pypi/+simple/"
export UV_INDEX_URL="https://pypi.ops.eblu.me/root/pypi/+simple/"

Unset both to fall back to public PyPI (e.g. when indri is offline).

The dotfiles repo has shell config that manages this toggle.

Upload Packages

# Build and publish with uv
cd ~/code/personal/your-package
uv build
uv publish --publish-url https://pypi.ops.eblu.me/eblume/dev/

# First time: uv will prompt for credentials

Create Users/Indices

# Login as root
uvx devpi use https://pypi.ops.eblu.me
uvx devpi login root

# Create user (prompts for password - store in 1Password)
uvx devpi user -c USERNAME email=EMAIL

# Create index inheriting from PyPI mirror
uvx devpi index -c USERNAME/dev bases=root/pypi

Verify Cache

# Check if devpi is caching
curl -s https://pypi.ops.eblu.me/+api | jq
  • devpi - Service reference