Is PyPI down in South Africa today?

pip install Fails With Connection Error

If pip times out or throws a connection error mid-install, the most common culprit is a corporate firewall or a flaky network dropping the TCP connection. Try switching to a different network first. If that doesn''t help, point pip at a mirror: add --index-url https://pypi.org/simple/ explicitly, or configure a trusted host in your pip.ini. Also worth checking: pip version. Anything below 22.x has known SSL negotiation quirks.

Package Upload Returns 400 or 403

A 400 on twine upload usually means the metadata is malformed — check your setup.cfg or pyproject.toml for missing required fields like version or author. A 403 almost always means the API token is wrong or scoped incorrectly. Tokens are project-scoped now by default; if you''re uploading to a new project, generate a token with ''Entire account'' scope for the first upload, then switch to project-scoped.

Search Returns No Results or Hangs

The built-in search on the site has been intentionally limited for years — it''s not a bug, it''s a policy. Use pip search is fully deprecated and returns an error. For real package discovery, use https://​pypi.​org/​search/?​q=​yourquery directly in the browser, or switch to tools like pip index versions packagename to check availability from the CLI.

Two-Factor Auth Code Rejected on Login

- Make sure your authenticator app is time-synced; TOTP codes are valid for 30 seconds and clock drift of even 60 seconds breaks them

- If you lost access to your 2FA device, recovery codes shown during setup are the only option — PyPI support cannot bypass 2FA

- Hardware keys (WebAuthn) sometimes fail in older browsers; try Chrome or Firefox latest

Newly Uploaded Version Not Appearing

After a successful upload, CDN propagation takes anywhere from a few seconds to 5 minutes. If pip still can''t find the new version after that window, run pip install packagename==x.y.z --no-cache-dir to bypass the local cache. Also double-check that the version string in your package metadata exactly matches what you''re querying — pre-release tags like rc1 require --pre flag to install.

Account Email Confirmation Not Arriving

Check spam first. If nothing shows up after 10 minutes, the address might have a typo — PyPI lets you update your email in account settings and resend the confirmation. Gmail aliases with dots or plus signs occasionally cause delivery issues; use a plain address if possible.