ErrLookup › pypa/pip

pypa/pip

The Python package installer · Python · 408 source files

Analyzed at f399c37189 on 2026-08-08. 350 documented errors.

Code / MessageTypeSeverityTags
Cannot use '--only-dependencies' in combination with
exception error cli-options, only-dependencies, conflict, command-error
No module named
exception error pip-internal, import-audit-hook, installation, safety-mechanism, corrupt-install
Script requires a different Python: not in
exception error python-version, pep723, requirements-from-script, unsupported-python, command-error
When restricting platform and interpreter constraints using…
exception error cli-options, platform, abi, binary, cross-target, command-error
Platform and interpreter constraints using…
exception error cli-options, platform, pylock, requirements-file, command-error
Can not perform a '--user' install. User site-packages are…
exception error pip, install, user-site, configuration, environment
Failed to run pip under
exception error cli-options, python-interpreter, subprocess, command-error
Python executable failed to copy to
exception error venv, build-isolation, windows, antivirus, venv-creation
This version of pip does not support python
exception critical python-version, compatibility, pip-runner, system-exit
Directory entries are not supported in remote pylock.toml
exception error pylock, directory-entry, remote-lock, validation
--requirements-from-script can only be given once
exception error cli-options, requirements-from-script, pep723, command-error
path outside destination: %r
exception error security, path-traversal, zip-slip, distlib, archive, unarchive
Including subprocess data sources from specific root_dir is…
exception error distro, configuration, validation, subprocess
is a symlink; Will not return uid for symlinks
exception warning security, symlink, aix, jython, toctou
Path in pylock file obtained from a URL resolves outside…
exception error pylock, path-traversal, security, url, remote-lock
Cannot select requirements from pylock file
exception error pylock, package-selection, validation, lock-file
Will not install to the user site because it will lack…
exception error user-site, virtualenv, sys-path
--require-hashes and --no-require-hashes are mutually…
exception error cli-options, hashes, conflict, command-error
Cannot restore Specifier from
exception error packaging, specifiers, pickle, serialization, version-mismatch
Invalid member in the tar file
exception critical security, tar-slip, path-traversal, unpacking, tarfile, pep-706
Unexpected file name derived from URL
validation error link, url, filesystem, validation, security
Unknown hash name
exception error hashes, validation, requirements-file, hashlib
DEPRECATION: pip will enforce this behaviour change.
exception error deprecation, versioning, migration, pip-internal
Package URL cannot contain fragments in combination with…
exception error pylock, vcs, url-fragment, subdirectory, validation
is installed but is required by
exception error pkg-resources, dependency-conflict, version-conflict, contextual
THESE PACKAGES DO NOT MATCH THE HASHES FROM THE…
exception critical hashes, security, tamper-detection, require-hashes, integrity
Hashes are required in --require-hashes mode, but they are…
exception error hashes, require-hashes, missing-hash, requirements-file
User base directory is not specified
exception error installation, user-install, scheme, sysconfig
name is invalid
validation error packaging, utils, validation, pep503, package-name
--refresh-package option requires 1 argument.
exception error cli-options, refresh-package, arguments, command-error
Some build dependencies for
exception error pip, build, dependencies, conflict, pep517
Absolute paths are not supported in pylock files obtained…
exception error pylock, absolute-path, security, remote-lock, url
--build-constraint cannot be used with --no-build-isolation.
exception error cli-options, build-constraint, build-isolation, command-error
This environment is externally managed
exception error pep-668, externally-managed, virtualenv, system-python, security
No input was expected ($PIP_NO_INPUT set); question
exception error no-input, automation, ci, environment, interactive
--pre cannot be used with --all-releases or --only-final.
exception error cli-options, pre-release, release-control, conflict, command-error
Cannot serialize
exception error msgpack, serialization, type-error, custom-types
Error reading pylock file
exception error pylock, io-error, network, file-not-found, url
unknown command
exception error cli-options, unknown-command, typo, command-error
Cannot restore Version from
exception error versioning, pickle, serialization, packaging
Could not install locked package
exception error installation, lock-file, format-control, resolution
You must give at least one requirement to
exception error cli-options, requirements, find-links, command-error
Can not use any platform or abi specific options unless…
exception error cli-options, platform, target, dry-run, command-error
Invalid specification
exception error parsing, entry-points, distlib, metadata, specification
Invalid specifier
validation error packaging, validation, specifiers, pep440
For req: .
exception error wheel-install, installation, error-context, pip
Unexpected HTTP request on what should be a secure…
exception error security, network, https, mitm
Invalid pylock file
exception error pylock, toml, schema-validation, parse-error, validation
Undefined on and .
exception error markers, pep508, pep440, packaging
Requested has inconsistent Name between its PEP 658…
exception error pep658, metadata, sidecar, name, index, pip
Cannot restore SpecifierSet from
exception error packaging, specifiers, pickle, serialization, version-mismatch
invalid requirement
exception error parsing, requirements, pep508, distlib, syntax-error
The zip file ( ) has a file ( ) trying to install outside…
exception critical security, zip-slip, path-traversal, unpacking, zipfile
Unable to verify server certificate for
exception error ssl, certificates, network, security, tls
set relations do not support === specifiers
validation error packaging, specifiers, pep440, arbitrary-equality, api-usage
To modify pip, please run the following command
exception error windows, self-upgrade, pip-modification, command-error
Unknown license exception
validation error spdx, license, validation, packaging
Cannot restore value from
exception error packaging, pickle, deserialization, version-compat, vendored
unexpected trailing data
exception error parsing, requirements, pep508, distlib, syntax-error
No matching distribution found for
exception error cli, pip-index, package-resolution, network, index
local must be a valid version string, got
validation error version, local-version, packaging, pep440
Cannot restore from
exception error packaging, pickle, deserialization, version-compat, vendored
invalid-egg-fragment
The ' ' egg fragment is invalid
exception error packaging, vcs-install, pep508, url-fragment
incomplete-download
Download failed because not enough bytes were received
exception error download, network, http-range, resume
%r not a successor of anything
exception error sequencer, graph, distlib, dependency-ordering, lifecycle
Too many arguments
exception error cli-options, cache, arguments, command-error
Cannot combine SpecifierSets with True and False prerelease…
validation error packaging, specifiers, prereleases, configuration
Failed to build one or more wheels
exception error pip, wheel, build, compilation, filesystem
Could not locate Python interpreter
exception error cli-options, python-interpreter, path, command-error
failed-wheel-build-for-install
Failed to build installable wheels for some pyproject.toml based projects
exception error cli, pip-install, wheel-build, build-failure, native-extension, dependencies
Tag has an invalid interpreter
validation error packaging, tags, validation, pep425, identifier
Use of .. or absolute path in a resource path is not…
validation warning pkg-resources, resources, security, path-traversal, deprecation
Unexpected type (expected )
validation error packaging, pep610, json-validation, direct-url, vendored
invalid truth value
exception error validation, configuration, strtobool, environment
Unknown format for %r
exception error archive, unarchive, distlib, file-format, unsupported-extension
path ' ' cannot be absolute
exception error filesystem, paths, windows, distlib, packaging
Cannot serialize where tzinfo=None
exception error msgpack, datetime, timezone, serialization
is not a supported wheel for this platform. It can't be…
exception error pip, wheel, platform, compatibility, architecture
"egg_name" is empty. This likely means no egg could be…
exception error packaging, zip, extraction, egg, pkg-resources
Cannot combine '--path' with '--user' or '--local'
exception error cli-options, list, path, conflict, command-error
typecode must have int type.
exception error msgpack, ext-type, type-error, validation
Bad metadata in (invalid metadata entry `version`)
exception error metadata, version, bad-metadata, importlib
Can not open an editor for a file name containing
exception error cli, pip-config, security, shell-injection-guard, edge-case
Fatal Internal error [id=2]. Please report as a bug.
exception error pip, config, internal, bug
Requested has inconsistent Requires-Dist between its PEP…
exception error pep658, metadata, sidecar, requires-dist, index, pip
resolution-too-deep
Dependency resolution exceeded maximum depth
exception error pip, resolver, dependency, resolution, resolution-too-deep
Requested has invalid metadata: Requires-Dist in
exception error metadata, pep508, requires-dist, validation, pip
"os.rename" and "os.unlink" are not supported on this…
exception error pkg-resources, resources, platform, extraction, gae
Got invalid value for load_only - should be one of
exception error pip, config, configuration, internal, validation
%r not a successor of %r
exception error sequencer, graph, distlib, dependency-ordering, idempotency
--all-releases / --only-final option requires 1 argument.
validation error cli, release-control, argument-validation, command-error
At least one hash must be provided
validation error pylock, validation, hashes
Domain too long
exception error idna, dns, validation, length-limit
Index does not provide upload-time metadata.
exception error installation, index, metadata, upload-time
Unknown: %r
exception error sequencer, graph, distlib, dependency-ordering, topological-sort
invalid glob %r: recursive glob "**" must be used alone
exception error glob, distlib, filesystem, pattern-matching, recursive-glob
invalid-installed-package
Cannot process installed package
exception error installed-package, invalid-version, pep440
Invalid quoted string
validation error packaging, markers, pep508, parsing, vendored
Some build dependencies for
exception error pip, build, dependencies, missing, pep517
Invalid wheel filename (compressed tag set components must…
validation error wheel, filename, tags, pep425, packaging