From cec88ead1a0a3b5cb19fb9f06f39263e9858f3b9 Mon Sep 17 00:00:00 2001 From: FSSCoding Date: Sat, 6 Sep 2025 17:26:17 +1000 Subject: [PATCH] CRITICAL: Fix virtual environment activation issues - Use direct .venv/bin/python paths to bypass activation problems - Install packages using full path method (bypasses system restrictions) - Activate environment only after installation for command usage - Handles systems where source .venv/bin/activate fails to override system Python Fixes virtual environment detection issues in restricted environments. --- README.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/README.md b/README.md index 7fcdeca..42ae14a 100644 --- a/README.md +++ b/README.md @@ -87,23 +87,24 @@ cd Fss-Mini-Rag # Install dependencies and package python3 -m venv .venv + +# CRITICAL: Use full path activation for reliability +.venv/bin/python -m pip install -r requirements.txt +.venv/bin/python -m pip install . + +# Activate environment for using the command source .venv/bin/activate # Linux/macOS # .venv\Scripts\activate # Windows - -# 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 +# Use direct path method (bypasses system restrictions entirely) +.venv/bin/python -m pip install -r requirements.txt --break-system-packages +.venv/bin/python -m pip install . --break-system-packages -# 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 +# Then activate for using the command +source .venv/bin/activate ``` **Step 2: Start Using**