Error Knowledge Base PIP WINDOWS_NOT_RECOGNIZED

'pip' is not recognized as an internal or external command, operable program or batch file.

On Windows, `cmd.exe`/PowerShell can't find `pip.exe` on PATH (or you're using the wrong Python install).

Affected versions: All pip versions (this is a PATH/interpreter selection issue).

What This Error Means

On Windows, cmd.exe/PowerShell can't find pip.exe on PATH (or you're using the wrong Python install).

How to Fix It

  1. Use the Windows Python launcher: py -m pip ... (recommended).
  2. If you need pip directly, add the correct ...\PythonXX\Scripts\ directory to PATH (or use the venv's Scripts\).
  3. If pip is missing, reinstall Python and ensure the "pip" component is enabled, or use py -m ensurepip --upgrade where available.
  4. Prefer per-project virtual environments to avoid global PATH confusion.

Why It Happens

  • Python was installed without pip (or pip was removed).
  • You're using a Python install that isn't the one you think (multiple Python installs).
  • The Scripts\ directory for that Python/venv isn't on PATH.

How to Verify

  1. Run py -m pip --version and confirm it succeeds.
  2. Re-run your original install command using py -m pip install ....

Manual Windows launcher checks

  1. Confirm which Python the launcher selects: py -0p.
  2. Check pip through the launcher: py -m pip --version.
  3. If using a virtual environment, ensure it's activated and then run: python -m pip --version.

Common CLI Output

'pip' is not recognized as an internal or external command, operable program or batch file

How pip is launched on Windows

  1. On Windows, pip is typically installed as a console script (for example pip.exe) inside a Python install or virtual environment's Scripts\ directory.
  2. If that Scripts\ directory is not on PATH (or you intended to use a different Python), pip will not be found.

Prevention Tips

  • Use py -m pip on Windows instead of calling pip.exe directly.
  • Create and activate a venv per project (py -m venv .venv) and install inside it.
  • Avoid manually editing PATH for multiple Python installs unless you standardize on one.

Where This Can Be Triggered

Not thrown by pip itself

This message is emitted by your shell / OS launcher (or by the Python interpreter) before pip runs, so there is no pip source file/line to link to.

Need help or found a mistake? Contact RepoFlow support for questions.

Join our mailing list