# ERROR: Could not find a version that satisfies the requirement some-package (from versions: none)

- **ID:** `python/pip-installation-error-no-matching-distribution`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

The package name is misspelled, the package does not exist on PyPI, or the index being used does not have it. Also occurs when network issues prevent fetching the package list.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.7 | active | — | — |
| 3.8 | active | — | — |
| 3.9 | active | — | — |
| 3.10 | active | — | — |
| 3.11 | active | — | — |
| 3.12 | active | — | — |

## Workarounds

1. **** (95% success)
   ```
   Double-check the package name on PyPI (https://pypi.org). Use pip search (if available) or web search to find correct name.
   ```
2. **** (80% success)
   ```
   If behind a proxy, set environment variables: export HTTP_PROXY=http://proxy:port and HTTPS_PROXY=https://proxy:port.
   ```

## Dead Ends

- **** — If the package name is wrong, no index will have it; if network is down, still fails. (60% fail)
- **** — Cache is not the issue if the package doesn't exist; clearing doesn't help. (90% fail)