Document FAISS as optional with upload instructions

.gitignore

@@ -51,4 +51,3 @@ htmlcov/
 # Temporary files
 *.tmp
 *.bak
-knowledge_base/faiss_index/*.faiss

FAISS_SETUP.md

@@ -0,0 +1,70 @@
+# FAISS Knowledge Base Setup for Hugging Face Space
+
+## Why FAISS Files Can't Be in Git
+
+The FAISS index file (`index.faiss`, ~200KB) is a binary file that cannot be pushed via git to Hugging Face Spaces without Git LFS. Since Git LFS setup requires additional configuration, we provide alternative methods.
+
+## Option 1: Upload via Hugging Face Web Interface (Recommended)
+
+1. Go to your Space: https://huggingface.co/spaces/Ralitza1/LolMultiAgent/tree/main
+2. Click "Files and versions"
+3. Click "+ Add file" > "Upload files"
+4. Navigate to and upload:
+   - `knowledge_base/faiss_index/index.faiss` (202KB)
+   - `knowledge_base/faiss_index/index.pkl` (already uploaded)
+5. Commit the changes
+6. The Space will automatically rebuild
+
+## Option 2: Upload via Python API
+
+```python
+from huggingface_hub import HfApi
+
+# Your HF token (keep this secret!)
+token = "YOUR_HUGGINGFACE_TOKEN"
+
+# Initialize API
+api = HfApi()
+
+# Upload FAISS file
+api.upload_file(
+    path_or_fileobj="./knowledge_base/faiss_index/index.faiss",
+    path_in_repo="knowledge_base/faiss_index/index.faiss",
+    repo_id="Ralitza1/LolMultiAgent",
+    repo_type="space",
+    token=token
+)
+
+print("✅ FAISS file uploaded successfully!")
+```
+
+## Option 3: Use Without FAISS
+
+The system is designed to work without FAISS. If the FAISS knowledge base is not available:
+- The Knowledge Base Agent will still work using Tavily web search
+- You'll see a warning: "⚠️ FAISS knowledge base not available"
+- All other agents (Build Advisor, Match Analyzer, etc.) will function normally
+
+## Verify FAISS is Working
+
+After uploading, check the Space logs for:
+```
+✅ FAISS knowledge base loaded successfully
+```
+
+If you see this error:
+```
+❌ Error loading FAISS knowledge base: Error: 'f' failed: could not open knowledge_base/faiss_index/index.faiss
+```
+
+Then the file needs to be uploaded using one of the methods above.
+
+## What is FAISS?
+
+FAISS (Facebook AI Similarity Search) is a vector database containing League of Legends knowledge:
+- Champion abilities and stats
+- Game mechanics
+- Meta information
+- Strategy tips
+
+It enables the Knowledge Base Agent to answer LoL-specific questions without making external API calls.

README.md

@@ -54,6 +54,10 @@ Simply type your questions in the chat interface:
 - **LangChain/LangGraph** - Multi-agent framework
 - **OpenAI GPT-4** - Language model
 - **Gradio 6.2.0** - Web interface
-- **FAISS** - Vector database
+- **FAISS** - Vector database (optional, see FAISS_SETUP.md)
 - **Riot API** - Live game data
 - **Tavily** - Real-time web search
+
+## Note: FAISS Knowledge Base
+
+The FAISS knowledge base is **optional** and provides enhanced LoL knowledge retrieval. If not available, the system will work perfectly using Tavily web search instead. See [FAISS_SETUP.md](./FAISS_SETUP.md) for upload instructions if you want to enable it.