pip: Could not find a version that satisfies the requirement

#Что означает ошибка

ERROR: Could not find a version that satisfies the requirement X и No matching distribution found for X означают, что pip не нашёл подходящий релиз пакета для вашей версии Python, платформы или индекса. Причина — не отсутствие интернета, а несовпадение требований.

Часто пакет не поддерживает слишком новую или слишком старую версию Python.

Проверьте три вещи: имя, версию Python и разрядность.

Проверьте имя пакета, версию Python и индекс пакетов.

#Причины и решения

#Пошаговое решение

1. Проверьте имя пакета на PyPIОткройте страницу https://pypi.org/ и найдите название пакета точно как оно написано в requirements.txt или команде. В терминале активированного окружения выполните python -m pip index versions ИМЯ_ПАКЕТА, заменив заглушку. Если индекс настроен на частный сервер, сравните с указанным в python -m pip config list (не публикуйте секретные адреса и пароли). Неправильное имя, несуществующий пакет или версия в == часто приводят к этой ошибке; проблема не всегда в pip.
2. Проверьте версию PythonВ том же терминале выполните python --version, python -m pip --version и python -c "import sys; print(sys.executable)". В Windows, где используется py, проверьте py -0p и используйте py -m pip для нужного интерпретатора. Убедитесь, что проект запускается тем же Python, для которого устанавливаете пакет. На странице PyPI откройте «Requires: Python» и проверьте ограничения требуемой версии; старые или новые версии Python могут не поддерживаться.
3. Обновите pipЕсли pip очень старый и вы используете своё виртуальное окружение, после проверки резервирования зависимостей выполните python -m pip install --upgrade pip; в системном Python на Linux сначала изучите правила дистрибутива и не меняйте системный pip через sudo. Новая версия pip лучше понимает некоторые форматы пакетов, но не создаст отсутствующую сборку. Повторите python -m pip index versions ИМЯ_ПАКЕТА и исходную команду установки только после проверки совместимости.
4. Проверьте разрядность PythonНа странице PyPI нужного выпуска откройте «Download files»: посмотрите, есть ли wheel для вашей ОС, версии Python и архитектуры (например, win_amd64, manylinux, macosx, cp312). Для проверки архитектуры выполните python -c "import platform; print(platform.machine(), platform.architecture())". Если доступны только исходники, установка может требовать компилятор и заголовки; это отдельная ошибка сборки. Не скачивайте бинарные файлы с неизвестных сайтов ради отсутствующего wheel.
5. Установите подходящую версию PythonЕсли пакет не поддерживает текущий интерпретатор, выберите документированную совместимую версию пакета либо установите поддерживаемую версию Python отдельно и создайте новое виртуальное окружение python -m venv .venv в отдельной папке проекта. Не удаляйте действующее окружение и не меняйте системный Python без необходимости. Активируйте новое окружение по инструкции вашей ОС, проверьте python -m pip --version и установите зависимость в нём. При неудаче сохраните полный текст ошибки, имя пакета, ОС и версию Python.

#Имя и версия Python

Проверьте имя на pypi.org: опечатки (opencv-python, а не cv2), регистр и дефисы. Узнайте версию: python --version. Откройте страницу пакета → «Download files» и посмотрите поддерживаемые версии (тег cp312 означает Python 3.12). Для новых версий Python колёса могут быть ещё не выпущены: используйте предыдущую версию Python или установите нужную через pyenv / py -3.11.

#Разрядность и платформа

Python должен быть 64-разрядным: python -c "import struct;print(struct.calcsize('P')*8)". На Apple Silicon и ARM-Windows часть пакетов не имеет готовых колёс. Старые pip не понимают новые теги: обновите python -m pip install --upgrade pip.

#Индекс и сеть

Для диагностики проверьте выбранный индекс (python -m pip config list без публикации секретов), установленную версию Python и список доступных файлов релиза на PyPI. Если пакет требует сборки из исходников, изучите системные требования компилятора; --no-deps не решает отсутствие подходящей версии пакета и может создать неполную установку. Не передавайте пароли прокси прямо в командной строке.