BobAi
a1f84e2bd5
- Changed primary model recommendation from qwen3:1.7b to qwen3:4b - Added Q8 quantization info in technical docs for production users - Fixed method name error: get_embedding_info() -> get_status() - Updated all error messages and test files with new recommendations - Maintained beginner-friendly options (1.7b still very good, 0.6b surprisingly good) - Added explanation of why small models work well with RAG context - Comprehensive testing completed - system ready for clean release
86 lines
2.7 KiB
Python
Executable File
86 lines
2.7 KiB
Python
Executable File
#!/usr/bin/env python3
|
|
"""
|
|
FSS-Mini-RAG Troubleshooting Tool
|
|
|
|
A beginner-friendly troubleshooting tool that checks your setup
|
|
and helps identify what's working and what needs attention.
|
|
|
|
Run with: python3 tests/troubleshoot.py
|
|
"""
|
|
|
|
import sys
|
|
import subprocess
|
|
from pathlib import Path
|
|
|
|
# Add project to path
|
|
sys.path.insert(0, str(Path(__file__).parent.parent))
|
|
|
|
def main():
|
|
"""Run comprehensive troubleshooting checks."""
|
|
|
|
print("🔧 FSS-Mini-RAG Troubleshooting Tool")
|
|
print("=" * 50)
|
|
print("This tool checks your setup and helps fix common issues.")
|
|
print()
|
|
|
|
# Menu of available tests
|
|
print("Available tests:")
|
|
print(" 1. Full Ollama Integration Test")
|
|
print(" 2. Smart Ranking Test")
|
|
print(" 3. Basic System Validation")
|
|
print(" 4. All Tests (recommended)")
|
|
print()
|
|
|
|
choice = input("Select test (1-4, or Enter for all): ").strip()
|
|
|
|
if choice == "1" or choice == "" or choice == "4":
|
|
print("\n" + "🤖 OLLAMA INTEGRATION TESTS".center(50, "="))
|
|
run_test("test_ollama_integration.py")
|
|
|
|
if choice == "2" or choice == "" or choice == "4":
|
|
print("\n" + "🧮 SMART RANKING TESTS".center(50, "="))
|
|
run_test("test_smart_ranking.py")
|
|
|
|
if choice == "3" or choice == "" or choice == "4":
|
|
print("\n" + "🔍 SYSTEM VALIDATION TESTS".center(50, "="))
|
|
run_test("03_system_validation.py")
|
|
|
|
print("\n" + "✅ TROUBLESHOOTING COMPLETE".center(50, "="))
|
|
print("💡 If you're still having issues:")
|
|
print(" • Check docs/QUERY_EXPANSION.md for setup help")
|
|
print(" • Ensure Ollama is installed: https://ollama.ai/download")
|
|
print(" • Start Ollama server: ollama serve")
|
|
print(" • Install models: ollama pull qwen3:4b")
|
|
|
|
def run_test(test_file):
|
|
"""Run a specific test file."""
|
|
test_path = Path(__file__).parent / test_file
|
|
|
|
if not test_path.exists():
|
|
print(f"❌ Test file not found: {test_file}")
|
|
return
|
|
|
|
try:
|
|
# Run the test
|
|
result = subprocess.run([
|
|
sys.executable, str(test_path)
|
|
], capture_output=True, text=True, timeout=60)
|
|
|
|
# Show output
|
|
if result.stdout:
|
|
print(result.stdout)
|
|
if result.stderr:
|
|
print("STDERR:", result.stderr)
|
|
|
|
if result.returncode == 0:
|
|
print(f"✅ {test_file} completed successfully!")
|
|
else:
|
|
print(f"⚠️ {test_file} had some issues (return code: {result.returncode})")
|
|
|
|
except subprocess.TimeoutExpired:
|
|
print(f"⏰ {test_file} timed out after 60 seconds")
|
|
except Exception as e:
|
|
print(f"❌ Error running {test_file}: {e}")
|
|
|
|
if __name__ == "__main__":
|
|
main() |