Add application files

DEPENDENCY_FIX.md

@@ -0,0 +1,117 @@
+# Dependency Version Fix
+
+## Issue
+`ImportError: huggingface-hub>=0.19.3,<1.0 is required for a normal functioning of this module, but found huggingface-hub==1.1.4`
+
+## Root Cause
+Version conflict between `transformers` and `huggingface-hub`. The `transformers` 4.x series requires `huggingface-hub<1.0`.
+
+## Solution
+
+### Option 1: Fresh Install (Recommended)
+
+```bash
+# Remove existing packages
+pip uninstall -y huggingface-hub transformers sentence-transformers
+
+# Reinstall with correct versions
+pip install -r requirements_gradio.txt
+```
+
+### Option 2: Force Correct Versions
+
+```bash
+# Install specific compatible versions
+pip install "huggingface-hub>=0.19.3,<1.0" "transformers>=4.36.0,<5.0"
+```
+
+### Option 3: Use Virtual Environment (Best Practice)
+
+```bash
+# Create fresh environment
+python -m venv venv
+source venv/bin/activate  # On Windows: venv\Scripts\activate
+
+# Install all dependencies fresh
+pip install -r requirements_gradio.txt
+```
+
+## Verification
+
+After fixing, verify the installation:
+
+```bash
+python -c "import transformers; import huggingface_hub; print(f'transformers: {transformers.__version__}'); print(f'huggingface-hub: {huggingface_hub.__version__}')"
+```
+
+Expected output:
+```
+transformers: 4.36.x or higher (but <5.0)
+huggingface-hub: 0.19.x - 0.99.x (but <1.0)
+```
+
+## For Hugging Face Spaces
+
+The `requirements_gradio.txt` has been updated with correct version constraints:
+
+```txt
+huggingface-hub>=0.19.3,<1.0
+transformers>=4.36.0,<5.0
+```
+
+When you push to HF Spaces, it will automatically use the correct versions.
+
+## Why This Happened
+
+The original `requirements_gradio.txt` had:
+- `huggingface-hub==0.26.2` (pinned)
+- `transformers==4.45.0` (pinned)
+
+These are compatible, but if pip resolved dependencies differently or if there was a cached version, it might install `huggingface-hub>=1.0`, which breaks `transformers` 4.x.
+
+## Fixed Version Constraints
+
+Now using version ranges for better compatibility:
+- `huggingface-hub>=0.19.3,<1.0` - Compatible with transformers 4.x
+- `transformers>=4.36.0,<5.0` - Modern enough for features, <5.0 for compatibility
+
+## Still Getting Errors?
+
+### Error: "No module named 'transformers'"
+```bash
+pip install transformers
+```
+
+### Error: "No module named 'sentence_transformers'"
+```bash
+pip install sentence-transformers
+```
+
+### Error: Version conflict persists
+```bash
+# Nuclear option - remove all and reinstall
+pip freeze | xargs pip uninstall -y
+pip install -r requirements_gradio.txt
+```
+
+## Testing
+
+After fixing, test the import:
+
+```bash
+python -c "from app.orchestrator import Orchestrator; print('✓ All imports successful')"
+```
+
+If successful, you'll see:
+```
+✓ All imports successful
+```
+
+## Running the App
+
+```bash
+# Start the Gradio app
+python app.py
+```
+
+The app should now start without import errors!

requirements.txt

@@ -16,4 +16,6 @@ aiohttp==3.9.1
 pandas==2.1.4
 # NEW: Web search integration
 duckduckgo-search==4.1.1
-huggingface-hub==0.20.2
+# HuggingFace dependencies (compatible versions)
+huggingface-hub>=0.19.3,<1.0
+transformers>=4.36.0,<5.0

requirements_gradio.txt

@@ -3,9 +3,10 @@
 # Gradio Interface
 gradio==5.5.0
 
-# Hugging Face
-huggingface-hub==0.26.2
-transformers==4.45.0
+# Hugging Face (compatible versions)
+# Note: transformers 4.x requires huggingface-hub<1.0
+huggingface-hub>=0.19.3,<1.0
+transformers>=4.36.0,<5.0
 
 # FastAPI (for backend components)
 fastapi==0.109.0