# WARNING: The script foo is installed in '/home/user/.local/bin' which is not on PATH.
  Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.

- **ID:** `python/pip-legacy-version-scheme`
- **Domain:** python
- **Category:** install_error
- **Verification:** ai_generated
- **Fix Rate:** 80%

## Root Cause

pip installed console_scripts into the user site bin directory (because of --user or a non-activated venv), but that directory is not on the shell's PATH, so the command isn't found.

## Version Compatibility

| Version | Status | Introduced | Deprecated |
|---------|--------|------------|------------|
| 3.x | active | — | — |

## Workarounds

1. **** (90% success)
   ```
   Add the dir to PATH: export PATH="$HOME/.local/bin:$PATH"  # append to ~/.bashrc or ~/.zshrc to persist
   ```
2. **** (88% success)
   ```
   Use a venv so scripts install into the active env: python -m venv .venv && . .venv/bin/activate && pip install foo
   ```

## Dead Ends

- **** — Suppresses the warning but the script still lands off-PATH; running foo still gives command not found. (75% fail)
- **** — Reinstalls to the same location; PATH is unchanged so the command remains undiscoverable. (70% fail)