Поиск
Ошибки

pip: Could not find a version that satisfies the requirement — пакет не найден

pip не нашёл ни одной версии пакета, которую можно поставить на этот Python. В скобках после from versions — какие версии он видит; по ним понятно, в чём причина.

≈ 5 мин чтения
Содержание 8

Как выглядит ошибка

ERROR: Could not find a version that satisfies the requirement example-pkg==2.0 (from versions: 1.0, 1.1, 1.2)
ERROR: No matching distribution found for example-pkg==2.0

После слова requirement — что вы просили поставить, в скобках — версии, которые pip нашёл и может поставить на ваш Python. Тексты сверены с исходным кодом pip 24.0 из пакетов Ubuntu 24.04 и pip 25.1.1 из пакетов Ubuntu 26.04. Команды pip на этой странице вводятся во включённом окружении venv: в начале строки ввода видно (venv). Как его создать и включить — в разделе Виртуальное окружение venv.

Что значит список версий

Что в скобкахВ чём делоГде решение
from versions: noneпакета с таким именем нет, нет связи с индексом пакетов или ни одна версия не подходит к вашему Pythonраздел ниже
список версий, но нужной в нём нетнужная версия не подходит к вашему Python или её нет совсемраздел ниже
requirement requirements.txtзабыт ключ -rраздел ниже

Если в скобках none

Проверьте по очереди:

  1. Имя пакета. Сверьте его с документацией библиотеки: имя для pip может отличаться от имени в import — примеры в разделе про ModuleNotFoundError.
  2. Связь с индексом пакетов. Если выше ошибки есть строки WARNING со словом Retrying, pip не смог скачать список версий. Проверьте, открываются ли с сервера сайты: curl -I https://pypi.org/simple/. В ответе первая строка должна быть с кодом 200.
  3. Версию Python. Если выше есть строка Ignored the following versions that require a different python version, пакету нужен другой Python — раздел ниже.

Если пакет ставится только под другую систему или процессор, pip тоже покажет none: проверьте на странице пакета на pypi.org, есть ли файлы для Linux и вашей версии Python.

Если нужной версии нет в списке

У пакета может быть ограничение Requires-Python — с какими версиями Python он работает. Версии, которые не подходят, pip пропускает и пишет об этом выше ошибки:

ERROR: Ignored the following versions that require a different python version: 2.0 Requires-Python >=3.13
ERROR: Could not find a version that satisfies the requirement example-pkg==2.0 (from versions: 1.0, 1.1, 1.2)

Здесь версии 2.0 нужен Python 3.13 или новее, а на сервере другой. Узнайте свою версию:

python --version

Что можно сделать:

  • поставить последнюю версию из списка в скобках — в примере pip install example-pkg==1.2 — и поправить номер в requirements.txt;
  • взять сервер с более новым Python: в Ubuntu 24.04 стоит Python 3.12, в Ubuntu 26.04 — Python 3.14 (как узнать версию Ubuntu).

Похожее сообщение Package 'example-pkg' requires a different Python: 3.12.3 not in '>=3.13' значит то же самое: пакету нужен Python новее того, что стоит.

Если строки Ignored нет, а нужной версии нет в списке, такой версии пакета не существует. Проверьте номер на странице пакета на pypi.org. Строка Ignored the following yanked versions перечисляет версии, которые автор пакета отозвал.

Если в ошибке requirements.txt

ERROR: Could not find a version that satisfies the requirement requirements.txt (from versions: none)
HINT: You are attempting to install a package literally named "requirements.txt" (which cannot exist). Consider using the '-r' flag to install the packages listed in requirements.txt
ERROR: No matching distribution found for requirements.txt

pip принял имя файла за имя пакета. Добавьте ключ -r, и pip прочитает список из файла:

pip install -r requirements.txt

Как проверить

Повторите установку. В конце ответа должна быть строка Successfully installed и имя пакета с версией. Посмотреть, что стоит в окружении:

pip list

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше