Add robust installation method for externally-managed-environment
- Use python -m pip instead of pip for better virtual environment handling - Add troubleshooting section for PEP 668 externally-managed-environment errors - Include --break-system-packages workaround when needed in virtual environments Addresses system-level pip restrictions that block installation even in venvs.
This commit is contained in:
parent
6d441fa5af
commit
919f7284a9
17
README.md
17
README.md
@ -89,8 +89,21 @@ cd Fss-Mini-Rag
|
|||||||
python3 -m venv .venv
|
python3 -m venv .venv
|
||||||
source .venv/bin/activate # Linux/macOS
|
source .venv/bin/activate # Linux/macOS
|
||||||
# .venv\Scripts\activate # Windows
|
# .venv\Scripts\activate # Windows
|
||||||
pip install -r requirements.txt
|
|
||||||
pip install .
|
# Use python -m pip for reliability (handles externally-managed-environment errors)
|
||||||
|
python -m pip install -r requirements.txt
|
||||||
|
python -m pip install .
|
||||||
|
```
|
||||||
|
|
||||||
|
**If you get "externally-managed-environment" error:**
|
||||||
|
```bash
|
||||||
|
# Verify virtual environment is active
|
||||||
|
which python # Should show .venv/bin/python
|
||||||
|
python -m pip --version # Should show .venv path
|
||||||
|
|
||||||
|
# If still failing, use override (safe in virtual environment)
|
||||||
|
python -m pip install -r requirements.txt --break-system-packages
|
||||||
|
python -m pip install . --break-system-packages
|
||||||
```
|
```
|
||||||
|
|
||||||
**Step 2: Start Using**
|
**Step 2: Start Using**
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user