Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,11 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+.vector_services/usiu_vector_db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text
+images/2D[[:space:]]&[[:space:]]3D[[:space:]]Plots[[:space:]]of[[:space:]]vectors[[:space:]]2.png filter=lfs diff=lfs merge=lfs -text
+images/2D[[:space:]]&[[:space:]]3D[[:space:]]Plots[[:space:]]of[[:space:]]vectors.png filter=lfs diff=lfs merge=lfs -text
+images/2D[[:space:]]Vectors.png filter=lfs diff=lfs merge=lfs -text
+images/3D[[:space:]]Vectors[[:space:]]2.png filter=lfs diff=lfs merge=lfs -text
+images/3D[[:space:]]Vectors.png filter=lfs diff=lfs merge=lfs -text
+usiu_vector_db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text
+vector_services/usiu_vector_db/chroma.sqlite3 filter=lfs diff=lfs merge=lfs -text

.github/workflows/update_space.yml

@@ -0,0 +1,28 @@
+name: Run Python script
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout
+      uses: actions/checkout@v2
+
+    - name: Set up Python
+      uses: actions/setup-python@v2
+      with:
+        python-version: '3.9'
+
+    - name: Install Gradio
+      run: python -m pip install gradio
+
+    - name: Log in to Hugging Face
+      run: python -c 'import huggingface_hub; huggingface_hub.login(token="${{ secrets.hf_token }}")'
+
+    - name: Deploy to Spaces
+      run: gradio deploy

.gradio/certificate.pem

@@ -0,0 +1,31 @@
+-----BEGIN CERTIFICATE-----
+MIIFazCCA1OgAwIBAgIRAIIQz7DSQONZRGPgu2OCiwAwDQYJKoZIhvcNAQELBQAw
+TzELMAkGA1UEBhMCVVMxKTAnBgNVBAoTIEludGVybmV0IFNlY3VyaXR5IFJlc2Vh
+cmNoIEdyb3VwMRUwEwYDVQQDEwxJU1JHIFJvb3QgWDEwHhcNMTUwNjA0MTEwNDM4
+WhcNMzUwNjA0MTEwNDM4WjBPMQswCQYDVQQGEwJVUzEpMCcGA1UEChMgSW50ZXJu
+ZXQgU2VjdXJpdHkgUmVzZWFyY2ggR3JvdXAxFTATBgNVBAMTDElTUkcgUm9vdCBY
+MTCCAiIwDQYJKoZIhvcNAQEBBQADggIPADCCAgoCggIBAK3oJHP0FDfzm54rVygc
+h77ct984kIxuPOZXoHj3dcKi/vVqbvYATyjb3miGbESTtrFj/RQSa78f0uoxmyF+
+0TM8ukj13Xnfs7j/EvEhmkvBioZxaUpmZmyPfjxwv60pIgbz5MDmgK7iS4+3mX6U
+A5/TR5d8mUgjU+g4rk8Kb4Mu0UlXjIB0ttov0DiNewNwIRt18jA8+o+u3dpjq+sW
+T8KOEUt+zwvo/7V3LvSye0rgTBIlDHCNAymg4VMk7BPZ7hm/ELNKjD+Jo2FR3qyH
+B5T0Y3HsLuJvW5iB4YlcNHlsdu87kGJ55tukmi8mxdAQ4Q7e2RCOFvu396j3x+UC
+B5iPNgiV5+I3lg02dZ77DnKxHZu8A/lJBdiB3QW0KtZB6awBdpUKD9jf1b0SHzUv
+KBds0pjBqAlkd25HN7rOrFleaJ1/ctaJxQZBKT5ZPt0m9STJEadao0xAH0ahmbWn
+OlFuhjuefXKnEgV4We0+UXgVCwOPjdAvBbI+e0ocS3MFEvzG6uBQE3xDk3SzynTn
+jh8BCNAw1FtxNrQHusEwMFxIt4I7mKZ9YIqioymCzLq9gwQbooMDQaHWBfEbwrbw
+qHyGO0aoSCqI3Haadr8faqU9GY/rOPNk3sgrDQoo//fb4hVC1CLQJ13hef4Y53CI
+rU7m2Ys6xt0nUW7/vGT1M0NPAgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIBBjAPBgNV
+HRMBAf8EBTADAQH/MB0GA1UdDgQWBBR5tFnme7bl5AFzgAiIyBpY9umbbjANBgkq
+hkiG9w0BAQsFAAOCAgEAVR9YqbyyqFDQDLHYGmkgJykIrGF1XIpu+ILlaS/V9lZL
+ubhzEFnTIZd+50xx+7LSYK05qAvqFyFWhfFQDlnrzuBZ6brJFe+GnY+EgPbk6ZGQ
+3BebYhtF8GaV0nxvwuo77x/Py9auJ/GpsMiu/X1+mvoiBOv/2X/qkSsisRcOj/KK
+NFtY2PwByVS5uCbMiogziUwthDyC3+6WVwW6LLv3xLfHTjuCvjHIInNzktHCgKQ5
+ORAzI4JMPJ+GslWYHb4phowim57iaztXOoJwTdwJx4nLCgdNbOhdjsnvzqvHu7Ur
+TkXWStAmzOVyyghqpZXjFaH3pO3JLF+l+/+sKAIuvtd7u+Nxe5AW0wdeRlN8NwdC
+jNPElpzVmbUq4JUagEiuTDkHzsxHpFKVK7q4+63SM1N95R1NbdWhscdCb+ZAJzVc
+oyi3B43njTOQ5yOf+1CceWxG1bQVs5ZufpsMljq4Ui0/1lvh+wjChP4kqKOJ2qxq
+4RgqsahDYVvTH9w7jXbyLeiNdd8XM2w9U/t7y0Ff/9yi0GE44Za4rF2LN9d11TPA
+mRGunUHBcnWEvgJBQl9nJEiU0Zsnvgc/ubhPgXRR4Xq37Z0j4r7g1SgEEzwxA57d
+emyPxgcYxn/eR44/KJ4EBs+lVDR3veyJm+kXQ99b21/+jh5Xos1AnX5iItreGCc=
+-----END CERTIFICATE-----

.vector_services/usiu_vector_db/chroma.sqlite3

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:e7f4d32541e51737af91299dcfae2e6c1919587a129154c993cc0fa7c9cc4096
+size 167936

README.md

@@ -1,12 +1,6 @@
 ---
-title: Chatbot Prototype
-emoji: 🐠
-colorFrom: indigo
-colorTo: red
-sdk: gradio
-sdk_version: 5.25.0
+title: chatbot_prototype
 app_file: app.py
-pinned: false
+sdk: gradio
+sdk_version: 5.12.0
 ---
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

api_gateway/gateway.py

@@ -0,0 +1,128 @@
+# api_gateway/gateway.py
+
+from typing import Dict, Any, Optional, List, Union, Callable
+import time
+import threading
+import logging
+
+# Configure logging
+logging.basicConfig(level=logging.INFO, 
+                   format='%(asctime)s - %(name)s - %(levelname)s - %(message)s')
+logger = logging.getLogger('api_gateway')
+
+class APIGateway:
+    """
+    A simple API Gateway that routes requests to appropriate services.
+    Implements service discovery, request routing, and basic monitoring.
+    """
+    
+    def __init__(self):
+        # Registry of available services
+        self._services = {}
+        
+        # Request metrics
+        self._request_count = 0
+        self._service_metrics = {}
+        self._lock = threading.Lock()
+        
+        # Start metrics reporting
+        self._start_metrics_reporting()
+        
+        logger.info("API Gateway initialized")
+    
+    def register_service(self, service_name: str, service_instance: Any) -> None:
+        """Register a service with the gateway"""
+        self._services[service_name] = service_instance
+        self._service_metrics[service_name] = {
+            "requests": 0,
+            "errors": 0,
+            "avg_response_time": 0
+        }
+        logger.info(f"Registered service: {service_name}")
+    
+    def get_service(self, service_name: str) -> Optional[Any]:
+        """Get a service instance by name"""
+        return self._services.get(service_name)
+    
+    def list_services(self) -> List[str]:
+        """List all registered services"""
+        return list(self._services.keys())
+    
+    def route_request(self, service_name: str, method_name: str, *args, **kwargs) -> Any:
+        """
+        Route a request to the appropriate service method
+        Handles metrics collection and error handling
+        """
+        service = self.get_service(service_name)
+        if not service:
+            logger.error(f"Service not found: {service_name}")
+            raise ValueError(f"Service '{service_name}' not found")
+        
+        method = getattr(service, method_name, None)
+        if not method or not callable(method):
+            logger.error(f"Method not found: {service_name}.{method_name}")
+            raise ValueError(f"Method '{method_name}' not found in service '{service_name}'")
+        
+        # Track request metrics
+        with self._lock:
+            self._request_count += 1
+            self._service_metrics[service_name]["requests"] += 1
+        
+        # Execute the request with timing
+        start_time = time.time()
+        try:
+            result = method(*args, **kwargs)
+            return result
+        except Exception as e:
+            logger.error(f"Error routing request to {service_name}.{method_name}: {str(e)}")
+            with self._lock:
+                self._service_metrics[service_name]["errors"] += 1
+            raise
+        finally:
+            # Calculate response time
+            response_time = time.time() - start_time
+            
+            # Update average response time
+            with self._lock:
+                metrics = self._service_metrics[service_name]
+                total_requests = metrics["requests"]
+                current_avg = metrics["avg_response_time"]
+                
+                # Calculate new rolling average
+                if total_requests > 1:
+                    new_avg = ((current_avg * (total_requests - 1)) + response_time) / total_requests
+                else:
+                    new_avg = response_time
+                
+                metrics["avg_response_time"] = new_avg
+    
+    def _start_metrics_reporting(self) -> None:
+        """Start a background thread to periodically report metrics"""
+        def report_metrics():
+            while True:
+                time.sleep(60)  # Report every minute
+                with self._lock:
+                    logger.info(f"Total requests processed: {self._request_count}")
+                    for service, metrics in self._service_metrics.items():
+                        logger.info(f"Service: {service}, "
+                                   f"Requests: {metrics['requests']}, "
+                                   f"Errors: {metrics['errors']}, "
+                                   f"Avg Response Time: {metrics['avg_response_time']:.4f}s")
+        
+        thread = threading.Thread(target=report_metrics, daemon=True)
+        thread.start()
+
+# Create a singleton instance
+gateway = APIGateway()
+
+def register_service(service_name: str, service_instance: Any) -> None:
+    """Register a service with the gateway"""
+    gateway.register_service(service_name, service_instance)
+
+def get_service(service_name: str) -> Optional[Any]:
+    """Get a service instance by name"""
+    return gateway.get_service(service_name)
+
+def route_request(service_name: str, method_name: str, *args, **kwargs) -> Any:
+    """Route a request to a service method"""
+    return gateway.route_request(service_name, method_name, *args, **kwargs)

app.py

@@ -0,0 +1,41 @@
+#!/usr/bin/env python
+import os
+import gradio as gr
+from services.data_service import DataService
+from services.ui_service import dashboard_ui
+from configs.config import GPT4O_MODEL, CLAUDE_MODEL
+from vector_services.data_curator import DataCurator
+from api_gateway.gateway import register_service, gateway
+
+def main() -> None:
+    base_dir = "./usiu-knowledge-base"
+    vector_store_dir = "week5/chatbot_prototype/vector_services/usiu_vector_db"
+
+    # Load the existing vector store and obtain its retriever
+    curator = DataCurator(knowledge_base_dir=base_dir, persist_directory=vector_store_dir)
+    vector_store = curator.load_vectorstore()
+    retriever = curator.get_retriever()
+
+    # Initialize DataService with the retriever so that general chat uses RAG
+    data_service = DataService(retriever=retriever)
+    
+    # Register services with API Gateway
+    register_service("data_service", data_service)
+    register_service("curator", curator)
+    
+    # Get system prompts for general and study support
+    general_chat_prompt, study_prompt = data_service.prompts_service.get_prompt()
+
+    # Build the dashboard, passing the relevant prompts, model identifiers, and retriever
+    dashboard = dashboard_ui(
+        general_chat_prompt=general_chat_prompt,
+        general_model=GPT4O_MODEL,
+        study_prompt=study_prompt,
+        study_model=CLAUDE_MODEL,
+        retriever=retriever  # Pass the retriever directly to ui_service
+    )
+    
+    dashboard.launch(share=True, inbrowser=True, server_name="0.0.0.0")
+
+if __name__ == "__main__":
+    main()

configs/config.py

@@ -0,0 +1,24 @@
+# configs/config.py
+import os
+import anthropic
+from dotenv import load_dotenv
+
+# Load environment variables from .env file.
+load_dotenv()
+
+claude = anthropic.Anthropic()
+
+# LLM Model Settings
+GPT4O_MODEL = "gpt-4o"  
+CLAUDE_MODEL = "claude-3-7-sonnet-20250219"  
+LLAMA_MODEL = "meta-llama/Meta-Llama-3-8B"
+
+# API Keys
+GPT4O_API_KEY = os.getenv('OPENAI_API_KEY')
+CLAUDE_API_KEY = os.getenv('ANTHROPIC_API_KEY')
+LLAMA_API_KEY = os.getenv("HF_TOKEN")
+
+# Scraping parameters
+SCRAPER_MAX_DEPTH = 3
+SCRAPER_MAX_PAGES = 200
+MIN_CONTENT_LENGTH = 200

main.py

@@ -0,0 +1,70 @@
+# #!/usr/bin/env python
+# import os
+# import gradio as gr
+# from services.data_service import DataService
+# from services.ui_service import general_chat_ui, study_support_ui
+# from configs.config import GPT4O_MODEL, CLAUDE_MODEL
+# from vector_services.data_curator import DataCurator
+
+# def main() -> None:
+#     base_dir = "./usiu-knowledge-base"
+#     vector_store_dir = "./usiu_vector_db"
+
+#     # Load the existing vector store and obtain its retriever.
+#     curator = DataCurator(knowledge_base_dir=base_dir, persist_directory=vector_store_dir)
+#     vector_store = curator.load_vectorstore()
+#     retriever = curator.get_retriever()
+
+#     # Initialize DataService with the retriever so that general chat uses RAG.
+#     data_service = DataService(retriever=retriever)
+#     prompts_service = data_service.prompts_service
+    
+#     # Get system prompts for general and study support.
+#     general_chat_prompt = prompts_service.get_prompt("general")
+#     study_prompt = prompts_service.get_prompt("study")
+
+#     # Use the ui_service functions that already manage state properly.
+#     general_ui = general_chat_ui(general_chat_prompt, GPT4O_MODEL)
+#     study_ui = study_support_ui(study_prompt, CLAUDE_MODEL)
+
+#     # Assemble the interfaces in tabs.
+#     interfaces = [general_ui, study_ui]
+#     tab_names = ["General Academic Chat", "Study Support Chat"]
+#     demo = gr.TabbedInterface(interfaces, tab_names)
+#     demo.launch(share=True, inbrowser=True, server_name="localhost", server_port=8001)
+
+# if __name__ == "__main__":
+#     main()
+
+
+#!/usr/bin/env python
+import os
+import gradio as gr
+from services.data_service import DataService
+from services.ui_service import dashboard_ui
+from configs.config import GPT4O_MODEL, CLAUDE_MODEL
+from vector_services.data_curator import DataCurator
+
+def main() -> None:
+    base_dir = "./usiu-knowledge-base"
+    vector_store_dir = "./vector_services/usiu_vector_db"
+
+    # Load the existing vector store and obtain its retriever.
+    curator = DataCurator(knowledge_base_dir=base_dir, persist_directory=vector_store_dir)
+    vector_store = curator.load_vectorstore()
+    retriever = curator.get_retriever()
+
+    # Initialize DataService with the retriever so that general chat uses RAG.
+    data_service = DataService(retriever=retriever)
+    prompts_service = data_service.prompts_service
+    
+    # Get system prompts for general and study support.
+    general_chat_prompt, study_prompt = prompts_service.get_prompt()
+
+    # Build the dashboard, passing the relevant prompts and model identifiers.
+    dashboard = dashboard_ui(general_chat_prompt, GPT4O_MODEL, study_prompt, CLAUDE_MODEL)
+    dashboard.launch(share=True, inbrowser=True, server_name="0.0.0.0")
+
+if __name__ == "__main__":
+    main()
+

requirements.txt

@@ -0,0 +1,564 @@
+absl-py==2.2.1
+accelerate==0.21.0
+aiofiles @ file:///home/conda/feedstock_root/build_artifacts/aiofiles_1698945915105/work
+aiohappyeyeballs @ file:///home/conda/feedstock_root/build_artifacts/aiohappyeyeballs_1733331917983/work
+aiohttp==3.11.11
+aiohttp-retry==2.8.3
+aiosignal @ file:///home/conda/feedstock_root/build_artifacts/aiosignal_1734342155601/work
+altair==5.5.0
+annotated-types @ file:///home/conda/feedstock_root/build_artifacts/annotated-types_1733247046149/work
+ansi2html @ file:///Users/runner/miniforge3/conda-bld/ansi2html_1726555528398/work
+anthropic==0.45.2
+anyascii==0.3.2
+anyio @ file:///home/conda/feedstock_root/build_artifacts/anyio_1736174388474/work
+appdirs==1.4.4
+appnope @ file:///home/conda/feedstock_root/build_artifacts/appnope_1733332318622/work
+argon2-cffi @ file:///home/conda/feedstock_root/build_artifacts/argon2-cffi_1733311059102/work
+argon2-cffi-bindings @ file:///Users/runner/miniforge3/conda-bld/argon2-cffi-bindings_1725356591756/work
+arrow @ file:///home/conda/feedstock_root/build_artifacts/arrow_1733584251875/work
+asgiref @ file:///home/conda/feedstock_root/build_artifacts/asgiref_1733215607532/work
+asttokens @ file:///home/conda/feedstock_root/build_artifacts/asttokens_1733250440834/work
+async-lru @ file:///home/conda/feedstock_root/build_artifacts/async-lru_1733584297267/work
+attrs @ file:///home/conda/feedstock_root/build_artifacts/attrs_1734348785146/work
+audioread==3.0.1
+babel @ file:///home/conda/feedstock_root/build_artifacts/babel_1733236348445/work
+backoff @ file:///home/conda/feedstock_root/build_artifacts/backoff_1733771078379/work
+bangla==0.0.2
+bcrypt @ file:///Users/runner/miniforge3/conda-bld/bcrypt_1732074870204/work
+beautifulsoup4==4.12.2
+bitsandbytes==0.42.0
+bleach @ file:///home/conda/feedstock_root/build_artifacts/bleach_1736148489770/work
+blinker @ file:///home/conda/feedstock_root/build_artifacts/blinker_1731096409132/work
+blis==1.2.0
+bnnumerizer==0.0.2
+bnunicodenormalizer==0.1.7
+Brotli @ file:///Users/runner/miniforge3/conda-bld/brotli-split_1725267563793/work
+build @ file:///home/conda/feedstock_root/build_artifacts/python-build_1733230610871/work
+cached-property @ file:///home/conda/feedstock_root/build_artifacts/cached_property_1615209429212/work
+cachetools @ file:///home/conda/feedstock_root/build_artifacts/cachetools_1737517575301/work
+catalogue==2.0.10
+certifi @ file:///home/conda/feedstock_root/build_artifacts/certifi_1734380492396/work/certifi
+cffi @ file:///Users/runner/miniforge3/conda-bld/cffi_1725560551097/work
+charset-normalizer==2.1.1
+chroma-hnswlib @ file:///Users/runner/miniforge3/conda-bld/chroma-hnswlib_1725527880077/work
+chromadb @ file:///Users/runner/miniforge3/conda-bld/chromadb_1736965865001/work
+chromedriver-autoinstaller==0.6.4
+click @ file:///home/conda/feedstock_root/build_artifacts/click_1734858813237/work
+clickhouse-connect @ file:///Users/runner/miniforge3/conda-bld/clickhouse-connect_1736287047793/work
+cloudpathlib==0.21.0
+colorama @ file:///home/conda/feedstock_root/build_artifacts/colorama_1733218098505/work
+coloredlogs @ file:///home/conda/feedstock_root/build_artifacts/coloredlogs_1733927977068/work
+comm @ file:///home/conda/feedstock_root/build_artifacts/comm_1733502965406/work
+confection==0.1.5
+contourpy @ file:///Users/runner/miniforge3/conda-bld/contourpy_1731428370657/work
+coqpit==0.0.17
+cryptography @ file:///Users/runner/miniforge3/conda-bld/cryptography-split_1737764929298/work
+cycler @ file:///home/conda/feedstock_root/build_artifacts/cycler_1733332471406/work
+cymem==2.0.11
+Cython==3.0.12
+dash @ file:///home/conda/feedstock_root/build_artifacts/dash_1734247674276/work
+dataclasses-json==0.5.14
+datasets==2.14.5
+dateparser==1.1.8
+debugpy @ file:///Users/runner/miniforge3/conda-bld/debugpy_1734158991118/work
+decorator @ file:///home/conda/feedstock_root/build_artifacts/decorator_1733236420667/work
+deepseek==1.0.0
+defusedxml @ file:///home/conda/feedstock_root/build_artifacts/defusedxml_1615232257335/work
+Deprecated @ file:///home/conda/feedstock_root/build_artifacts/deprecated_1737986966356/work
+dill==0.3.7
+distro==1.9.0
+dnspython @ file:///home/conda/feedstock_root/build_artifacts/dnspython_1733256735222/work
+docker-pycreds==0.4.0
+docopt==0.6.2
+duckdb @ file:///Users/runner/miniforge3/conda-bld/python-duckdb-split_1730798348017/work/tools/pythonpkg
+durationpy @ file:///home/conda/feedstock_root/build_artifacts/durationpy_1734343542351/work
+einops==0.8.1
+email_validator @ file:///home/conda/feedstock_root/build_artifacts/email-validator-meta_1733300719943/work
+encodec==0.1.1
+entrypoints @ file:///home/conda/feedstock_root/build_artifacts/entrypoints_1733327148154/work
+exceptiongroup @ file:///home/conda/feedstock_root/build_artifacts/exceptiongroup_1733208806608/work
+executing @ file:///home/conda/feedstock_root/build_artifacts/executing_1733569351617/work
+faiss==1.9.0
+faiss-cpu==1.10.0
+fastapi @ file:///home/conda/feedstock_root/build_artifacts/fastapi_1733362299471/work
+fastapi-cli @ file:///home/conda/feedstock_root/build_artifacts/fastapi-cli_1734302308128/work
+fastjsonschema @ file:///home/conda/feedstock_root/build_artifacts/python-fastjsonschema_1733235979760/work/dist
+feedparser==6.0.11
+ffmpy @ file:///home/conda/feedstock_root/build_artifacts/ffmpy_1659474992694/work
+filelock @ file:///home/conda/feedstock_root/build_artifacts/filelock_1733240801289/work
+Flask==2.2.2
+flatbuffers @ file:///home/conda/feedstock_root/build_artifacts/python-flatbuffers_1733838640534/work
+fonttools @ file:///Users/runner/miniforge3/conda-bld/fonttools_1735335860711/work
+fqdn @ file:///home/conda/feedstock_root/build_artifacts/fqdn_1733327382592/work/dist
+frozenlist @ file:///Users/runner/miniforge3/conda-bld/frozenlist_1737645277522/work
+fsspec==2023.6.0
+g2pkk==0.1.2
+gensim==4.3.3
+gitdb==4.0.12
+GitPython==3.1.44
+gmpy2 @ file:///Users/runner/miniforge3/conda-bld/gmpy2_1733462580180/work
+google-ai-generativelanguage==0.6.15
+google-api-core==2.24.0
+google-api-python-client==2.158.0
+google-auth @ file:///home/conda/feedstock_root/build_artifacts/google-auth_1737618250101/work
+google-auth-httplib2==0.2.0
+google-generativeai==0.8.4
+googleapis-common-protos @ file:///home/conda/feedstock_root/build_artifacts/googleapis-common-protos-feedstock_1731458889232/work
+gradio==5.23.1
+gradio_client==1.8.0
+groovy==0.1.2
+groq==0.18.0
+grpcio==1.69.0
+grpcio-status==1.69.0
+grpclib==0.4.7
+gruut==2.2.3
+gruut-ipa==0.13.0
+gruut_lang_de==2.0.1
+gruut_lang_en==2.0.1
+gruut_lang_es==2.0.1
+gruut_lang_fr==2.0.2
+gTTS==2.5.4
+h11 @ file:///home/conda/feedstock_root/build_artifacts/h11_1733327467879/work
+h2 @ file:///home/conda/feedstock_root/build_artifacts/h2_1733298745555/work
+hangul-romanize==0.1.0
+hnswlib @ file:///Users/runner/miniforge3/conda-bld/hnswlib_1732136479184/work
+hpack @ file:///home/conda/feedstock_root/build_artifacts/hpack_1733299205993/work
+httpcore @ file:///home/conda/feedstock_root/build_artifacts/bld/rattler-build_httpcore_1731707562/work
+httplib2==0.22.0
+httptools @ file:///Users/runner/miniforge3/conda-bld/httptools_1732707694945/work
+httpx==0.27.2
+httpx-sse==0.4.0
+huggingface-hub==0.29.3
+humanfriendly @ file:///home/conda/feedstock_root/build_artifacts/humanfriendly_1733927922002/work
+hyperframe @ file:///home/conda/feedstock_root/build_artifacts/hyperframe_1733298771451/work
+idna @ file:///home/conda/feedstock_root/build_artifacts/idna_1733211830134/work
+importlib_metadata @ file:///home/conda/feedstock_root/build_artifacts/importlib-metadata_1721856510709/work
+importlib_resources @ file:///home/conda/feedstock_root/build_artifacts/importlib_resources_1736252299705/work
+inflect==7.5.0
+ipykernel @ file:///Users/runner/miniforge3/conda-bld/ipykernel_1719845458456/work
+ipython @ file:///home/conda/feedstock_root/build_artifacts/ipython_1734788142186/work
+ipywidgets @ file:///home/conda/feedstock_root/build_artifacts/ipywidgets_1733493556527/work
+isoduration @ file:///home/conda/feedstock_root/build_artifacts/isoduration_1733493628631/work/dist
+itsdangerous @ file:///home/conda/feedstock_root/build_artifacts/itsdangerous_1733308265247/work
+jamo==0.4.1
+jedi @ file:///home/conda/feedstock_root/build_artifacts/jedi_1733300866624/work
+jieba==0.42.1
+Jinja2 @ file:///home/conda/feedstock_root/build_artifacts/jinja2_1734823942230/work
+jiter==0.8.2
+jiwer==3.1.0
+joblib @ file:///home/conda/feedstock_root/build_artifacts/joblib_1733736026804/work
+json5 @ file:///home/conda/feedstock_root/build_artifacts/json5_1733272076743/work
+jsonlines==1.2.0
+jsonpatch==1.33
+jsonpointer @ file:///Users/runner/miniforge3/conda-bld/jsonpointer_1725302946874/work
+jsonschema @ file:///home/conda/feedstock_root/build_artifacts/jsonschema_1733472696581/work
+jsonschema-specifications @ file:///tmp/tmpk0f344m9/src
+jupyter-dash @ file:///home/conda/feedstock_root/build_artifacts/jupyter-dash_1648919001274/work
+jupyter-events @ file:///home/conda/feedstock_root/build_artifacts/jupyter_events_1734531682843/work
+jupyter-lsp @ file:///home/conda/feedstock_root/build_artifacts/jupyter-lsp-meta_1733492907176/work/jupyter-lsp
+jupyter_client @ file:///home/conda/feedstock_root/build_artifacts/jupyter_client_1733440914442/work
+jupyter_core @ file:///home/conda/feedstock_root/build_artifacts/jupyter_core_1727163409502/work
+jupyter_server @ file:///home/conda/feedstock_root/build_artifacts/jupyter_server_1734702637701/work
+jupyter_server_terminals @ file:///home/conda/feedstock_root/build_artifacts/jupyter_server_terminals_1733427956852/work
+jupyterlab @ file:///home/conda/feedstock_root/build_artifacts/jupyterlab_1738184697351/work
+jupyterlab_pygments @ file:///home/conda/feedstock_root/build_artifacts/jupyterlab_pygments_1733328101776/work
+jupyterlab_server @ file:///home/conda/feedstock_root/build_artifacts/jupyterlab_server_1733599573484/work
+jupyterlab_widgets @ file:///home/conda/feedstock_root/build_artifacts/jupyterlab_widgets_1733428046021/work
+kiwisolver @ file:///Users/runner/miniforge3/conda-bld/kiwisolver_1725459112978/work
+kubernetes @ file:///home/conda/feedstock_root/build_artifacts/python-kubernetes_1737737545868/work
+langchain==0.3.4
+langchain-chroma==0.2.1
+langchain-community==0.3.3
+langchain-core==0.3.34
+langchain-openai==0.3.4
+langchain-text-splitters==0.3.6
+langchainplus-sdk==0.0.20
+langcodes==3.5.0
+langsmith==0.1.147
+language_data==1.3.0
+lazy_loader==0.4
+librosa==0.10.2.post1
+linkify-it-py==2.0.3
+llvmlite==0.44.0
+lz4 @ file:///Users/runner/miniforge3/conda-bld/lz4_1725089476490/work
+marisa-trie==1.2.1
+Markdown==3.7
+markdown-it-py==2.2.0
+MarkupSafe @ file:///Users/runner/miniforge3/conda-bld/markupsafe_1724959500379/work
+marshmallow==3.25.0
+matplotlib==3.7.2
+matplotlib-inline @ file:///home/conda/feedstock_root/build_artifacts/matplotlib-inline_1733416936468/work
+mdit-py-plugins==0.3.3
+mdurl @ file:///home/conda/feedstock_root/build_artifacts/mdurl_1733255585584/work
+mistune @ file:///home/conda/feedstock_root/build_artifacts/mistune_1735686876364/work
+mmh3 @ file:///Users/runner/miniforge3/conda-bld/mmh3_1737968080672/work
+modal==0.73.126
+monotonic @ file:///home/conda/feedstock_root/build_artifacts/monotonic_1734029696393/work
+more-itertools==10.6.0
+mpmath @ file:///home/conda/feedstock_root/build_artifacts/mpmath_1733302684489/work
+msgpack==1.1.0
+multidict @ file:///Users/runner/miniforge3/conda-bld/multidict_1729065505264/work
+multiprocess==0.70.15
+munkres==1.1.4
+murmurhash==1.0.12
+mypy-extensions==1.0.0
+narwhals==1.25.2
+nbclient @ file:///home/conda/feedstock_root/build_artifacts/nbclient_1734628800805/work
+nbconvert @ file:///home/conda/feedstock_root/build_artifacts/nbconvert-meta_1736258671456/work
+nbformat @ file:///home/conda/feedstock_root/build_artifacts/nbformat_1733402752141/work
+nest_asyncio @ file:///home/conda/feedstock_root/build_artifacts/nest-asyncio_1733325553580/work
+networkx==2.8.8
+nltk==3.9.1
+notebook_shim @ file:///home/conda/feedstock_root/build_artifacts/notebook-shim_1733408315203/work
+num2words==0.5.14
+numba==0.61.0
+numexpr==2.10.2
+numpy @ file:///Users/runner/miniforge3/conda-bld/numpy_1707225640867/work/dist/numpy-1.26.4-cp311-cp311-macosx_11_0_arm64.whl#sha256=b62b8b824024855c3eb209bd45bfcf60bc9a11b94cbf9d5b7b25dc503021e672
+oauthlib @ file:///home/conda/feedstock_root/build_artifacts/oauthlib_1733752848439/work
+ollama==0.4.7
+onnxruntime @ file:///Users/runner/miniforge3/conda-bld/onnxruntime_1735443977499/work/build-ci/Release/dist/onnxruntime-1.20.1-cp311-cp311-macosx_11_0_arm64.whl#sha256=f2a0666c1ab7a3326e5ff6b4c81cef4246c1d88692eff576fb61d17628379742
+openai==1.68.2
+openai-whisper==20240930
+openapi-schema-pydantic==1.2.4
+opentelemetry-api==1.29.0
+opentelemetry-exporter-otlp-proto-common==1.29.0
+opentelemetry-exporter-otlp-proto-grpc==1.29.0
+opentelemetry-instrumentation==0.50b0
+opentelemetry-instrumentation-asgi==0.50b0
+opentelemetry-instrumentation-fastapi==0.50b0
+opentelemetry-proto==1.29.0
+opentelemetry-sdk==1.29.0
+opentelemetry-semantic-conventions==0.50b0
+opentelemetry-util-http==0.50b0
+orjson==3.10.14
+outcome==1.3.0.post0
+overrides @ file:///home/conda/feedstock_root/build_artifacts/overrides_1734587627321/work
+packaging==23.2
+pandas==1.5.3
+pandocfilters @ file:///home/conda/feedstock_root/build_artifacts/pandocfilters_1631603243851/work
+parso @ file:///home/conda/feedstock_root/build_artifacts/parso_1733271261340/work
+pathtools==0.1.2
+peft==0.4.0
+pexpect @ file:///home/conda/feedstock_root/build_artifacts/pexpect_1733301927746/work
+pickleshare @ file:///home/conda/feedstock_root/build_artifacts/pickleshare_1733327343728/work
+pillow @ file:///Users/runner/miniforge3/conda-bld/pillow_1735929745664/work
+pkgutil_resolve_name @ file:///home/conda/feedstock_root/build_artifacts/pkgutil-resolve-name_1733344503739/work
+platformdirs @ file:///home/conda/feedstock_root/build_artifacts/platformdirs_1733232627818/work
+plotly==5.15.0
+pooch==1.8.2
+posthog @ file:///home/conda/feedstock_root/build_artifacts/posthog_1726036274425/work
+preshed==3.0.9
+prometheus_client @ file:///home/conda/feedstock_root/build_artifacts/prometheus_client_1733327310477/work
+prompt_toolkit @ file:///home/conda/feedstock_root/build_artifacts/prompt-toolkit_1733302527033/work
+propcache @ file:///Users/runner/miniforge3/conda-bld/propcache_1737635547864/work
+proto-plus==1.25.0
+protobuf==5.29.4
+psutil==5.9.8
+ptyprocess @ file:///home/conda/feedstock_root/build_artifacts/ptyprocess_1733302279685/work/dist/ptyprocess-0.7.0-py2.py3-none-any.whl#sha256=92c32ff62b5fd8cf325bec5ab90d7be3d2a8ca8c8a3813ff487a8d2002630d1f
+pulsar-client @ file:///Users/runner/miniforge3/conda-bld/pulsar-client_1725542299588/work/dist/pulsar_client-3.5.0-cp311-cp311-macosx_11_0_arm64.whl#sha256=1570a636e1ae2647174be973a3c55b8f54e046f2e549b4e0043a4e18c9090df2
+pure_eval @ file:///home/conda/feedstock_root/build_artifacts/pure_eval_1733569405015/work
+pyarrow==17.0.0
+pyasn1 @ file:///home/conda/feedstock_root/build_artifacts/pyasn1_1733217608156/work
+pyasn1_modules @ file:///home/conda/feedstock_root/build_artifacts/pyasn1-modules_1733324602540/work
+pycparser @ file:///home/conda/feedstock_root/build_artifacts/bld/rattler-build_pycparser_1733195786/work
+pydantic==2.10.6
+pydantic-settings==2.7.1
+pydantic_core @ file:///Users/runner/miniforge3/conda-bld/pydantic-core_1734571525262/work
+pydub @ file:///home/conda/feedstock_root/build_artifacts/pydub_1734638032476/work
+pygame==2.6.1
+Pygments @ file:///home/conda/feedstock_root/build_artifacts/pygments_1736243443484/work
+PyJWT @ file:///home/conda/feedstock_root/build_artifacts/pyjwt_1732782409051/work
+pynndescent==0.5.13
+pyobjc==11.0
+pyobjc-core==11.0
+pyobjc-framework-Accessibility==11.0
+pyobjc-framework-Accounts==11.0
+pyobjc-framework-AddressBook==11.0
+pyobjc-framework-AdServices==11.0
+pyobjc-framework-AdSupport==11.0
+pyobjc-framework-AppleScriptKit==11.0
+pyobjc-framework-AppleScriptObjC==11.0
+pyobjc-framework-ApplicationServices==11.0
+pyobjc-framework-AppTrackingTransparency==11.0
+pyobjc-framework-AudioVideoBridging==11.0
+pyobjc-framework-AuthenticationServices==11.0
+pyobjc-framework-AutomaticAssessmentConfiguration==11.0
+pyobjc-framework-Automator==11.0
+pyobjc-framework-AVFoundation==11.0
+pyobjc-framework-AVKit==11.0
+pyobjc-framework-AVRouting==11.0
+pyobjc-framework-BackgroundAssets==11.0
+pyobjc-framework-BrowserEngineKit==11.0
+pyobjc-framework-BusinessChat==11.0
+pyobjc-framework-CalendarStore==11.0
+pyobjc-framework-CallKit==11.0
+pyobjc-framework-Carbon==11.0
+pyobjc-framework-CFNetwork==11.0
+pyobjc-framework-Cinematic==11.0
+pyobjc-framework-ClassKit==11.0
+pyobjc-framework-CloudKit==11.0
+pyobjc-framework-Cocoa==11.0
+pyobjc-framework-Collaboration==11.0
+pyobjc-framework-ColorSync==11.0
+pyobjc-framework-Contacts==11.0
+pyobjc-framework-ContactsUI==11.0
+pyobjc-framework-CoreAudio==11.0
+pyobjc-framework-CoreAudioKit==11.0
+pyobjc-framework-CoreBluetooth==11.0
+pyobjc-framework-CoreData==11.0
+pyobjc-framework-CoreHaptics==11.0
+pyobjc-framework-CoreLocation==11.0
+pyobjc-framework-CoreMedia==11.0
+pyobjc-framework-CoreMediaIO==11.0
+pyobjc-framework-CoreMIDI==11.0
+pyobjc-framework-CoreML==11.0
+pyobjc-framework-CoreMotion==11.0
+pyobjc-framework-CoreServices==11.0
+pyobjc-framework-CoreSpotlight==11.0
+pyobjc-framework-CoreText==11.0
+pyobjc-framework-CoreWLAN==11.0
+pyobjc-framework-CryptoTokenKit==11.0
+pyobjc-framework-DataDetection==11.0
+pyobjc-framework-DeviceCheck==11.0
+pyobjc-framework-DeviceDiscoveryExtension==11.0
+pyobjc-framework-DictionaryServices==11.0
+pyobjc-framework-DiscRecording==11.0
+pyobjc-framework-DiscRecordingUI==11.0
+pyobjc-framework-DiskArbitration==11.0
+pyobjc-framework-DVDPlayback==11.0
+pyobjc-framework-EventKit==11.0
+pyobjc-framework-ExceptionHandling==11.0
+pyobjc-framework-ExecutionPolicy==11.0
+pyobjc-framework-ExtensionKit==11.0
+pyobjc-framework-ExternalAccessory==11.0
+pyobjc-framework-FileProvider==11.0
+pyobjc-framework-FileProviderUI==11.0
+pyobjc-framework-FinderSync==11.0
+pyobjc-framework-FSEvents==11.0
+pyobjc-framework-GameCenter==11.0
+pyobjc-framework-GameController==11.0
+pyobjc-framework-GameKit==11.0
+pyobjc-framework-GameplayKit==11.0
+pyobjc-framework-HealthKit==11.0
+pyobjc-framework-ImageCaptureCore==11.0
+pyobjc-framework-InputMethodKit==11.0
+pyobjc-framework-InstallerPlugins==11.0
+pyobjc-framework-InstantMessage==11.0
+pyobjc-framework-Intents==11.0
+pyobjc-framework-IntentsUI==11.0
+pyobjc-framework-IOBluetooth==11.0
+pyobjc-framework-IOBluetoothUI==11.0
+pyobjc-framework-IOSurface==11.0
+pyobjc-framework-iTunesLibrary==11.0
+pyobjc-framework-KernelManagement==11.0
+pyobjc-framework-LatentSemanticMapping==11.0
+pyobjc-framework-LaunchServices==11.0
+pyobjc-framework-libdispatch==11.0
+pyobjc-framework-libxpc==11.0
+pyobjc-framework-LinkPresentation==11.0
+pyobjc-framework-LocalAuthentication==11.0
+pyobjc-framework-LocalAuthenticationEmbeddedUI==11.0
+pyobjc-framework-MailKit==11.0
+pyobjc-framework-MapKit==11.0
+pyobjc-framework-MediaAccessibility==11.0
+pyobjc-framework-MediaExtension==11.0
+pyobjc-framework-MediaLibrary==11.0
+pyobjc-framework-MediaPlayer==11.0
+pyobjc-framework-MediaToolbox==11.0
+pyobjc-framework-Metal==11.0
+pyobjc-framework-MetalFX==11.0
+pyobjc-framework-MetalKit==11.0
+pyobjc-framework-MetalPerformanceShaders==11.0
+pyobjc-framework-MetalPerformanceShadersGraph==11.0
+pyobjc-framework-MetricKit==11.0
+pyobjc-framework-MLCompute==11.0
+pyobjc-framework-ModelIO==11.0
+pyobjc-framework-MultipeerConnectivity==11.0
+pyobjc-framework-NaturalLanguage==11.0
+pyobjc-framework-NetFS==11.0
+pyobjc-framework-Network==11.0
+pyobjc-framework-NetworkExtension==11.0
+pyobjc-framework-NotificationCenter==11.0
+pyobjc-framework-OpenDirectory==11.0
+pyobjc-framework-OSAKit==11.0
+pyobjc-framework-OSLog==11.0
+pyobjc-framework-PassKit==11.0
+pyobjc-framework-PencilKit==11.0
+pyobjc-framework-PHASE==11.0
+pyobjc-framework-Photos==11.0
+pyobjc-framework-PhotosUI==11.0
+pyobjc-framework-PreferencePanes==11.0
+pyobjc-framework-PushKit==11.0
+pyobjc-framework-Quartz==11.0
+pyobjc-framework-QuickLookThumbnailing==11.0
+pyobjc-framework-ReplayKit==11.0
+pyobjc-framework-SafariServices==11.0
+pyobjc-framework-SafetyKit==11.0
+pyobjc-framework-SceneKit==11.0
+pyobjc-framework-ScreenCaptureKit==11.0
+pyobjc-framework-ScreenSaver==11.0
+pyobjc-framework-ScreenTime==11.0
+pyobjc-framework-ScriptingBridge==11.0
+pyobjc-framework-SearchKit==11.0
+pyobjc-framework-Security==11.0
+pyobjc-framework-SecurityFoundation==11.0
+pyobjc-framework-SecurityInterface==11.0
+pyobjc-framework-SensitiveContentAnalysis==11.0
+pyobjc-framework-ServiceManagement==11.0
+pyobjc-framework-SharedWithYou==11.0
+pyobjc-framework-SharedWithYouCore==11.0
+pyobjc-framework-ShazamKit==11.0
+pyobjc-framework-Social==11.0
+pyobjc-framework-SoundAnalysis==11.0
+pyobjc-framework-Speech==11.0
+pyobjc-framework-SpriteKit==11.0
+pyobjc-framework-StoreKit==11.0
+pyobjc-framework-Symbols==11.0
+pyobjc-framework-SyncServices==11.0
+pyobjc-framework-SystemConfiguration==11.0
+pyobjc-framework-SystemExtensions==11.0
+pyobjc-framework-ThreadNetwork==11.0
+pyobjc-framework-UniformTypeIdentifiers==11.0
+pyobjc-framework-UserNotifications==11.0
+pyobjc-framework-UserNotificationsUI==11.0
+pyobjc-framework-VideoSubscriberAccount==11.0
+pyobjc-framework-VideoToolbox==11.0
+pyobjc-framework-Virtualization==11.0
+pyobjc-framework-Vision==11.0
+pyobjc-framework-WebKit==11.0
+pyOpenSSL @ file:///home/conda/feedstock_root/build_artifacts/pyopenssl_1737243356468/work
+pyparsing==3.0.9
+PyPDF2==3.0.1
+PyPika @ file:///home/conda/feedstock_root/build_artifacts/pypika_1734974148700/work
+pypinyin==0.53.0
+pyproject_hooks @ file:///home/conda/feedstock_root/build_artifacts/pyproject_hooks_1733710025763/work
+pysbd==0.3.4
+PySocks @ file:///home/conda/feedstock_root/build_artifacts/pysocks_1733217236728/work
+pytesseract==0.3.13
+python-crfsuite==0.9.11
+python-dateutil @ file:///home/conda/feedstock_root/build_artifacts/python-dateutil_1733215673016/work
+python-dotenv @ file:///home/conda/feedstock_root/build_artifacts/python-dotenv_1733243180666/work
+python-json-logger @ file:///home/conda/feedstock_root/build_artifacts/python-json-logger_1677079630776/work
+python-multipart @ file:///home/conda/feedstock_root/build_artifacts/python-multipart_1734420773152/work
+pyttsx3==2.98
+pytz @ file:///home/conda/feedstock_root/build_artifacts/pytz_1706886791323/work
+pyu2f @ file:///home/conda/feedstock_root/build_artifacts/pyu2f_1733738580568/work
+PyYAML @ file:///Users/runner/miniforge3/conda-bld/pyyaml_1725456256847/work
+pyzmq @ file:///Users/runner/miniforge3/conda-bld/pyzmq_1728642247211/work
+RapidFuzz==3.12.2
+referencing @ file:///home/conda/feedstock_root/build_artifacts/referencing_1733366743674/work
+regex==2024.11.6
+requests==2.28.2
+requests-oauthlib @ file:///home/conda/feedstock_root/build_artifacts/requests-oauthlib_1733772243268/work
+requests-toolbelt==1.0.0
+retrying @ file:///home/conda/feedstock_root/build_artifacts/retrying_1721646300555/work
+rfc3339_validator @ file:///home/conda/feedstock_root/build_artifacts/rfc3339-validator_1733599910982/work
+rfc3986-validator @ file:///home/conda/feedstock_root/build_artifacts/rfc3986-validator_1598024191506/work
+rich @ file:///home/conda/feedstock_root/build_artifacts/rich_1733342254348/work/dist
+rich-toolkit @ file:///home/conda/feedstock_root/build_artifacts/bld/rattler-build_rich-toolkit_1733750834/work
+rpds-py @ file:///Users/runner/miniforge3/conda-bld/rpds-py_1733366661843/work
+rsa @ file:///home/conda/feedstock_root/build_artifacts/rsa_1733662684165/work
+ruff==0.9.5
+safehttpx @ file:///home/conda/feedstock_root/build_artifacts/safehttpx_1734360621373/work
+safetensors==0.5.2
+scikit-learn==1.3.0
+scipy==1.13.1
+selenium==4.10.0
+semantic-version @ file:///home/conda/feedstock_root/build_artifacts/semantic_version_1653579368137/work
+Send2Trash @ file:///Users/runner/miniforge3/conda-bld/send2trash_1733322099476/work
+sentence-transformers==2.2.2
+sentencepiece @ file:///Users/runner/miniforge3/conda-bld/sentencepiece-split_1727549050457/work/python
+sentry-sdk==2.20.0
+setproctitle==1.3.4
+sgmllib3k==1.0.0
+shellingham @ file:///home/conda/feedstock_root/build_artifacts/shellingham_1733300899265/work
+sigtools==4.0.1
+simpleaudio==1.0.4
+six @ file:///home/conda/feedstock_root/build_artifacts/six_1733380938961/work
+smart-open==7.1.0
+smmap==5.0.2
+sniffio @ file:///home/conda/feedstock_root/build_artifacts/sniffio_1733244044561/work
+sortedcontainers==2.4.0
+sounddevice==0.5.1
+soundfile==0.13.1
+soupsieve @ file:///home/conda/feedstock_root/build_artifacts/soupsieve_1693929250441/work
+soxr==0.5.0.post1
+spaces==0.32.0
+spacy==3.8.4
+spacy-legacy==3.0.12
+spacy-loggers==1.0.5
+SpeechRecognition==3.14.1
+speedtest-cli==2.1.3
+SQLAlchemy==1.4.54
+srsly==2.5.1
+stack_data @ file:///home/conda/feedstock_root/build_artifacts/stack_data_1733569443808/work
+starlette @ file:///home/conda/feedstock_root/build_artifacts/starlette_1733344384719/work
+SudachiDict-core==20250129
+SudachiPy==0.6.10
+sympy==1.13.1
+synchronicity==0.9.10
+tenacity==8.5.0
+tensorboard==2.19.0
+tensorboard-data-server==0.7.2
+terminado @ file:///Users/runner/miniforge3/conda-bld/terminado_1710263781917/work
+thinc==8.3.4
+threadpoolctl @ file:///home/conda/feedstock_root/build_artifacts/threadpoolctl_1714400101435/work
+tiktoken==0.8.0
+tinycss2 @ file:///home/conda/feedstock_root/build_artifacts/tinycss2_1729802851396/work
+tokenizers==0.13.3
+toml==0.10.2
+tomli @ file:///home/conda/feedstock_root/build_artifacts/tomli_1733256695513/work
+tomlkit @ file:///home/conda/feedstock_root/build_artifacts/tomlkit_1733230743009/work
+torch==2.6.0
+torchaudio==2.6.0
+torchvision==0.21.0
+tornado @ file:///Users/runner/miniforge3/conda-bld/tornado_1732615936501/work
+tqdm @ file:///home/conda/feedstock_root/build_artifacts/tqdm_1735661334605/work
+trainer==0.0.36
+traitlets @ file:///home/conda/feedstock_root/build_artifacts/traitlets_1733367359838/work
+transformers==4.30.0
+trio==0.29.0
+trio-websocket==0.12.2
+trl==0.5.0
+TTS==0.22.0
+twilio==9.4.4
+typeguard==4.4.2
+typer==0.15.1
+typer-slim==0.15.1
+types-certifi==2021.10.8.3
+types-python-dateutil @ file:///home/conda/feedstock_root/build_artifacts/types-python-dateutil_1733612335562/work
+types-toml==0.10.8.20240310
+typing-inspect==0.9.0
+typing_extensions @ file:///home/conda/feedstock_root/build_artifacts/typing_extensions_1733188668063/work
+typing_utils @ file:///home/conda/feedstock_root/build_artifacts/typing_utils_1733331286120/work
+tzdata @ file:///home/conda/feedstock_root/build_artifacts/python-tzdata_1733235305708/work
+tzlocal==5.3.1
+uc-micro-py==1.0.3
+umap==0.1.1
+umap-learn==0.5.7
+unicodedata2 @ file:///Users/runner/miniforge3/conda-bld/unicodedata2_1729704585212/work
+Unidecode==1.3.8
+uri-template @ file:///home/conda/feedstock_root/build_artifacts/uri-template_1733323593477/work/dist
+uritemplate==4.1.1
+urllib3==1.26.20
+uvicorn @ file:///home/conda/feedstock_root/build_artifacts/uvicorn_1734292939144/work
+uvloop @ file:///Users/runner/miniforge3/conda-bld/uvloop_1730214404471/work
+wandb==0.15.8
+wasabi==1.1.3
+watchfiles @ file:///Users/runner/miniforge3/conda-bld/watchfiles_1736550451638/work
+wcwidth @ file:///home/conda/feedstock_root/build_artifacts/wcwidth_1733231326287/work
+weasel==0.4.1
+webcolors @ file:///home/conda/feedstock_root/build_artifacts/webcolors_1733359735138/work
+webdriver-manager==3.8.6
+webencodings @ file:///home/conda/feedstock_root/build_artifacts/webencodings_1733236011802/work
+websocket-client @ file:///home/conda/feedstock_root/build_artifacts/websocket-client_1733157342724/work
+websockets==11.0.3
+Werkzeug==2.2.3
+whisper==1.1.10
+widgetsnbextension @ file:///home/conda/feedstock_root/build_artifacts/widgetsnbextension_1733128559935/work
+wrapt==1.17.1
+wsproto==1.2.0
+xxhash==3.5.0
+yarl @ file:///Users/runner/miniforge3/conda-bld/yarl_1737575825523/work
+zipp @ file:///home/conda/feedstock_root/build_artifacts/zipp_1732827521216/work
+zstandard==0.23.0

requirements2.txt

@@ -0,0 +1,10 @@
+gradio>=3.41.2
+openai>=0.28.0
+anthropic>=0.5.0
+python-dotenv>=1.0.0
+langchain>=0.0.267
+faiss-cpu>=1.7.4
+SpeechRecognition>=3.10.0
+gtts>=2.3.2
+playsound>=1.3.0
+PyAudio>=0.2.13

services/auth_service.py

@@ -0,0 +1,132 @@
+# services/auth_service.py
+
+import time
+import threading
+import uuid
+from typing import Dict, Optional, Any, Tuple
+
+# A simple dictionary of sample credentials.
+users = {
+    "adabor@usiu.ac.ke": "student123",
+    "adavid@usiu.ac.ke": "faculty123",
+    "jmilton@usiu.ac.ke": "staff123"
+}
+
+# Active user sessions storage
+active_sessions: Dict[str, Dict[str, Any]] = {}
+
+# Inactivity timeout in seconds (15 minutes)
+INACTIVITY_TIMEOUT = 15 * 60
+
+def authenticate(user_id: str, password: str) -> bool:
+    """Return True if the provided credentials match the lookup table."""
+    return users.get(user_id) == password
+
+def create_session(user_id: str) -> str:
+    """
+    Create a new user session with a unique session ID
+    Returns the session ID
+    """
+    session_id = str(uuid.uuid4())
+    active_sessions[session_id] = {
+        "user_id": user_id,
+        "logged_in": True,
+        "last_activity": time.time(),
+        "inactivity_timer": None,
+        "warned": False,
+        "created_at": time.time()
+    }
+    
+    # Set the initial inactivity timer
+    timer = threading.Timer(INACTIVITY_TIMEOUT, check_inactivity, args=[session_id])
+    timer.daemon = True
+    timer.start()
+    active_sessions[session_id]["inactivity_timer"] = timer
+    
+    return session_id
+
+def get_session(session_id: str) -> Optional[Dict[str, Any]]:
+    """Get session data for a given session ID"""
+    return active_sessions.get(session_id)
+
+def update_session_activity(session_id: str) -> bool:
+    """
+    Update the last activity timestamp for a session
+    Returns True if session was found and updated, False otherwise
+    """
+    if session_id in active_sessions:
+        active_sessions[session_id]["last_activity"] = time.time()
+        active_sessions[session_id]["warned"] = False
+        
+        # Reset inactivity timer if it exists
+        if active_sessions[session_id]["inactivity_timer"]:
+            active_sessions[session_id]["inactivity_timer"].cancel()
+        
+        # Set new inactivity timer
+        timer = threading.Timer(INACTIVITY_TIMEOUT, check_inactivity, args=[session_id])
+        timer.daemon = True
+        timer.start()
+        active_sessions[session_id]["inactivity_timer"] = timer
+        return True
+    return False
+
+def end_session(session_id: str) -> bool:
+    """
+    End a user session
+    Returns True if session was found and ended, False otherwise
+    """
+    if session_id in active_sessions:
+        # Cancel the inactivity timer if it exists
+        if active_sessions[session_id]["inactivity_timer"]:
+            active_sessions[session_id]["inactivity_timer"].cancel()
+        
+        # Remove the session
+        del active_sessions[session_id]
+        return True
+    return False
+
+def check_inactivity(session_id: str) -> None:
+    """Check if the session has been inactive for too long and mark it as logged out if so"""
+    if session_id in active_sessions:
+        current_time = time.time()
+        last_activity = active_sessions[session_id]["last_activity"]
+        
+        if current_time - last_activity >= INACTIVITY_TIMEOUT:
+            active_sessions[session_id]["logged_in"] = False
+            # The actual logout action will be handled by the UI when it detects this change
+
+def get_active_sessions() -> Dict[str, Dict[str, Any]]:
+    """Get all active sessions (for admin or debugging purposes)"""
+    return active_sessions
+
+def clear_expired_sessions() -> int:
+    """
+    Clear all expired sessions
+    Returns the number of sessions cleared
+    """
+    expired_count = 0
+    sessions_to_remove = []
+    
+    for session_id, session_data in active_sessions.items():
+        if not session_data["logged_in"]:
+            sessions_to_remove.append(session_id)
+    
+    for session_id in sessions_to_remove:
+        end_session(session_id)
+        expired_count += 1
+    
+    return expired_count
+
+# Start a background thread to periodically clean up expired sessions
+def cleanup_sessions_periodically(interval=3600):  # Default: every hour
+    """Start a background thread to periodically clean up expired sessions"""
+    def cleanup_task():
+        while True:
+            clear_expired_sessions()
+            time.sleep(interval)
+    
+    cleanup_thread = threading.Thread(target=cleanup_task, daemon=True)
+    cleanup_thread.start()
+
+# Initialize the session cleanup thread
+cleanup_sessions_periodically()

services/data_service-old1.py

@@ -0,0 +1,57 @@
+# services/data_service.py
+from services.system_prompts_service import SystemPromptsService
+from services.response_service import ResponseService
+from configs.config import GPT4O_MODEL, CLAUDE_MODEL, GPT4O_API_KEY, CLAUDE_API_KEY
+from services.general_chat_service import GeneralChatService  
+from services.study_support_service import StudySupportService
+from langchain.embeddings import OpenAIEmbeddings
+from langchain.vectorstores import Chroma
+
+class DataService:
+    """
+    Data service that routes user queries to the appropriate agent:
+      - General academic inquiries use GPT-4o via RAG if a retriever is provided,
+        using the general_chat function from GeneralChatService.
+      - Study support inquiries use Claude 3.5 Sonnet.
+    """
+    def __init__(self, retriever=None) -> None:
+        self.prompts_service = SystemPromptsService()
+        self.response_service = ResponseService()
+        
+        # If a retriever is provided as a string (e.g., a directory path),
+        # convert it into a proper retriever object.
+        if retriever and isinstance(retriever, str):
+            embeddings = OpenAIEmbeddings(openai_api_key=GPT4O_API_KEY)
+            vectorstore = Chroma(persist_directory=retriever, embedding_function=embeddings)
+            retriever = vectorstore.as_retriever(
+                search_type="mmr",
+                search_kwargs={'k': 40, 'lambda_mult': 0.6}
+            )
+
+        self.general_chat_service = GeneralChatService(
+            model=GPT4O_MODEL,
+            api_key=GPT4O_API_KEY,
+            system_prompt=self.prompts_service.get_prompt()[0],
+            retriever=retriever  # RAG will be used if this is a valid retriever object.
+        )
+        self.study_support_service = StudySupportService(
+            model=CLAUDE_MODEL,
+            api_key=CLAUDE_API_KEY,
+            system_prompt=self.prompts_service.get_prompt()[1]
+        )
+
+    def route_query(self, query: str, chat_history: any, query_type: str = "general") -> str:
+        """
+        Routes the user query to the appropriate service based on query type.
+        - If query_type is "study", the study support service is used.
+        - Otherwise, the general chat service (using general_chat) is used.
+        The final response is formatted via the response_service.
+        """
+        if query_type == "study":
+            response = self.study_support_service.ask(query)
+        else:
+            # Call the general_chat function which streams responses.
+            # Convert the generator into a list, and use the final yielded value.
+            responses = list(self.general_chat_service.general_chat(query, chat_history))
+            response = responses[-1] if responses else ""
+        return self.response_service.format_response(response)

services/data_service.py

@@ -0,0 +1,14 @@
+# services/data_service.py
+from services.system_prompts_service import SystemPromptsService
+
+class DataService:
+    """
+    Data service that provides access to system prompts and manages data-related operations.
+    """
+    def __init__(self, retriever=None) -> None:
+        self.prompts_service = SystemPromptsService()
+        self.retriever = retriever
+    
+    def get_retriever(self):
+        """Get the configured retriever for RAG"""
+        return self.retriever

services/file_service.py

@@ -0,0 +1,168 @@
+# services/file_service.py
+
+import os
+import io
+import PyPDF2
+import docx
+import pandas as pd
+import pptx
+from PIL import Image
+import openai
+import csv
+from typing import Dict, Any
+
+class FileProcessor:
+    """Service for processing different types of files"""
+    
+    @staticmethod
+    def read_file(file) -> str:
+        """
+        Extract content from various file types
+        Returns the content as a string
+        """
+        if file is None:
+            return "No file provided"
+            
+        file_extension = os.path.splitext(file.name)[1].lower()
+        
+        if file_extension == '.txt':
+            content = file.read().decode('utf-8')
+        elif file_extension == '.pdf':
+            pdf_reader = PyPDF2.PdfReader(file)
+            content = ''
+            for page in pdf_reader.pages:
+                text = page.extract_text()
+                if text:
+                    content += text
+        elif file_extension in ['.docx', '.doc']:
+            doc = docx.Document(file)
+            content = "\n".join([para.text for para in doc.paragraphs])
+        elif file_extension in ['.xlsx', '.xls']:
+            df = pd.read_excel(file)
+            content = df.to_string()
+        elif file_extension == '.csv':
+            # Reset file pointer to the beginning
+            file.seek(0)
+            
+            # First, try to read with pandas
+            try:
+                df = pd.read_csv(file)
+                content = df.to_string()
+            except Exception as e:
+                # If pandas fails, try with csv module
+                file.seek(0)
+                try:
+                    csv_content = []
+                    csv_reader = csv.reader(io.StringIO(file.read().decode('utf-8')))
+                    for row in csv_reader:
+                        csv_content.append(','.join(row))
+                    content = '\n'.join(csv_content)
+                except Exception as csv_e:
+                    content = f"Error processing CSV file: {str(csv_e)}"
+        elif file_extension in ['.pptx', '.ppt']:
+            prs = pptx.Presentation(file)
+            content = ''
+            for slide in prs.slides:
+                for shape in slide.shapes:
+                    if hasattr(shape, 'text'):
+                        content += shape.text + '\n'
+        elif file_extension in ['.png', '.jpg', '.jpeg', '.gif']:
+            try:
+                image = Image.open(file)
+                buffered = io.BytesIO()
+                image.save(buffered, format="PNG")
+                # Create an image variation via OpenAI's API
+                response = openai.Image.create_variation(
+                    image=buffered,
+                    n=1,
+                    size="256x256"
+                )
+                image_description = response['data'][0]['url']
+                content = f"[Image uploaded. Description: {image_description}]"
+            except Exception as e:
+                content = f"Error processing image: {str(e)}"
+        else:
+            content = f"Unsupported file type: {file_extension}"
+        
+        return content
+    
+    @staticmethod
+    def get_file_metadata(file) -> Dict[str, Any]:
+        """
+        Get metadata about a file
+        Returns a dictionary of file metadata
+        """
+        if file is None:
+            return {"error": "No file provided"}
+            
+        try:
+            file_extension = os.path.splitext(file.name)[1].lower()
+            file_size = os.path.getsize(file.name) if hasattr(file, 'name') else 0
+            
+            metadata = {
+                "filename": os.path.basename(file.name),
+                "extension": file_extension,
+                "size_bytes": file_size,
+                "size_formatted": FileProcessor._format_file_size(file_size)
+            }
+            
+            # Get additional metadata based on file type
+            if file_extension == '.pdf':
+                pdf_reader = PyPDF2.PdfReader(file)
+                metadata["pages"] = len(pdf_reader.pages)
+                if pdf_reader.metadata:
+                    metadata["author"] = pdf_reader.metadata.author
+                    metadata["creator"] = pdf_reader.metadata.creator
+                    metadata["producer"] = pdf_reader.metadata.producer
+            elif file_extension in ['.docx', '.doc']:
+                doc = docx.Document(file)
+                metadata["paragraphs"] = len(doc.paragraphs)
+            elif file_extension in ['.xlsx', '.xls']:
+                df = pd.read_excel(file)
+                metadata["rows"] = len(df)
+                metadata["columns"] = len(df.columns)
+            elif file_extension == '.csv':
+                # Reset file pointer
+                file.seek(0)
+                try:
+                    df = pd.read_csv(file)
+                    metadata["rows"] = len(df)
+                    metadata["columns"] = len(df.columns)
+                    
+                    # Get sample of column names
+                    col_sample = df.columns.tolist()[:5]
+                    if len(df.columns) > 5:
+                        col_sample.append("...")
+                    metadata["column_sample"] = col_sample
+                except Exception:
+                    # If pandas fails, try with csv module
+                    file.seek(0)
+                    try:
+                        csv_reader = csv.reader(io.StringIO(file.read().decode('utf-8')))
+                        rows = list(csv_reader)
+                        metadata["rows"] = len(rows)
+                        if rows:
+                            metadata["columns"] = len(rows[0])
+                    except Exception:
+                        pass
+            elif file_extension in ['.pptx', '.ppt']:
+                prs = pptx.Presentation(file)
+                metadata["slides"] = len(prs.slides)
+            elif file_extension in ['.png', '.jpg', '.jpeg', '.gif']:
+                image = Image.open(file)
+                metadata["dimensions"] = f"{image.width}x{image.height}"
+                metadata["mode"] = image.mode
+                metadata["format"] = image.format
+            
+            return metadata
+        except Exception as e:
+            return {"error": f"Error getting file metadata: {str(e)}"}
+    
+    @staticmethod
+    def _format_file_size(size_bytes: int) -> str:
+        """Format file size from bytes to human-readable format"""
+        for unit in ['B', 'KB', 'MB', 'GB']:
+            if size_bytes < 1024.0:
+                return f"{size_bytes:.2f} {unit}"
+            size_bytes /= 1024.0
+        return f"{size_bytes:.2f} TB"

services/quantized_model_loader.py

@@ -0,0 +1,67 @@
+import torch
+from transformers import AutoTokenizer, AutoModelForCausalLM, BitsAndBytesConfig
+from configs.config import GPT4O_MODEL, LLAMA_MODEL
+
+class QuantizedModelLoader:
+    """
+    This class loads a quantized model (either GPT-4.0 or Llama) at initialization.
+    The model is loaded in memory once and can be accessed via the `model` and `tokenizer` attributes.
+    
+    Parameters:
+        model_type (str): A string indicating which model to load.
+                          Expected values: "gpt4o" or "llama".
+        quant_4_bit (bool): If True, loads the model in 4-bit mode; otherwise, in 8-bit mode.
+    """
+    def __init__(self, model_type: str, quant_4_bit: bool = False):
+        self.quant_4_bit = quant_4_bit
+
+        # Select the model name from configuration.
+        if model_type.lower() == "gpt4o":
+            self.model_name = GPT4O_MODEL
+        elif model_type.lower() == "llama":
+            self.model_name = LLAMA_MODEL
+        else:
+            raise ValueError("Invalid model_type. Expected 'gpt4o' or 'llama'.")
+
+        self._initialize_model()
+
+    def _initialize_model(self):
+        # Set up quantization configuration.
+        if self.quant_4_bit:
+            quant_config = BitsAndBytesConfig(
+                load_in_4bit=True,
+                bnb_4bit_use_double_quant=True,
+                bnb_4bit_compute_dtype=torch.bfloat16,
+                bnb_4bit_quant_type="nf4"
+            )
+        else:
+            quant_config = BitsAndBytesConfig(
+                load_in_8bit=True,
+                bnb_8bit_compute_dtype=torch.bfloat16
+            )
+
+        # Load the tokenizer.
+        self.tokenizer = AutoTokenizer.from_pretrained(self.model_name, trust_remote_code=True)
+        self.tokenizer.pad_token = self.tokenizer.eos_token
+        self.tokenizer.padding_side = "right"
+
+        # Load the base model in quantized mode.
+        self.model = AutoModelForCausalLM.from_pretrained(
+            self.model_name,
+            quantization_config=quant_config,
+            device_map="auto"
+        )
+        # Update the tokenizer with the quantized model's pad token.
+        self.model.generation_config.pad_token_id = self.tokenizer.pad_token_id
+
+        print(f"Quantized model '{self.model_name}' loaded. Memory footprint: {self.model.get_memory_footprint() / 1e6:.1f} MB")
+
+# Expose the class for import.
+__all__ = ["QuantizedModelLoader"]
+
+if __name__ == "__main__":
+    # Initialization of the models.
+    print("Initializing GPT-4.0 quantized model loader:")
+    gpt_loader = QuantizedModelLoader("gpt4o", quant_4_bit=False)
+    print("Initializing Llama quantized model loader:")
+    llama_loader = QuantizedModelLoader("llama", quant_4_bit=False)

services/system_prompts_service.py

@@ -0,0 +1,15 @@
+# services/system_prompts_service.py
+
+from system_prompts.prompts_manager import get_system_prompt
+
+class SystemPromptsService:
+    def __init__(self):
+        self.general_prompt = (
+            get_system_prompt(model_type="general")
+        )
+        self.study_prompt = (
+            get_system_prompt(model_type="study")
+        )
+    
+    def get_prompt(self):
+            return [self.general_prompt, self.study_prompt]

services/ui_service-old2.py

@@ -0,0 +1,944 @@
+import re
+import os
+import time
+import openai
+import gradio as gr
+import PyPDF2
+import docx
+import pandas as pd
+import pptx
+from PIL import Image
+import io
+import base64
+import threading
+
+from configs.config import claude
+from .voice_interface import VoiceInterface
+from .auth_service import authenticate
+
+
+# Set the OpenAI API key from the environment variable
+openai.api_key = os.getenv('OPENAI_API_KEY')
+if not openai.api_key:
+    raise ValueError("OPENAI_API_KEY environment variable is not set. Please set it before running this script.")
+
+# Initialize Voice Interface
+voice_interface = VoiceInterface()
+
+def custom_css():
+    css = """
+    /* Professional custom CSS with transitions, hover effects, and responsive design */
+    /* Your existing CSS remains here - unchanged */
+    
+    /* Voice chat related CSS */
+    .voice-btn {
+        border-radius: 50%;
+        width: 45px;
+        height: 45px;
+        padding: 0;
+        display: flex;
+        align-items: center;
+        justify-content: center;
+        background-color: #000080;
+        color: white;
+        margin-right: 5px;
+        transition: all 0.3s ease;
+        box-shadow: 0 2px 5px rgba(0,0,0,0.2);
+    }
+    
+    .voice-btn:hover {
+        transform: scale(1.1);
+        background-color: #000066;
+        box-shadow: 0 4px 8px rgba(0,0,0,0.3);
+    }
+    
+    .voice-btn.recording {
+        background-color: #cc0000;
+        animation: pulse 1.5s infinite;
+    }
+    
+    @keyframes pulse {
+        0% { transform: scale(1); box-shadow: 0 0 0 0 rgba(204, 0, 0, 0.7); }
+        70% { transform: scale(1.1); box-shadow: 0 0 0 10px rgba(204, 0, 0, 0); }
+        100% { transform: scale(1); box-shadow: 0 0 0 0 rgba(204, 0, 0, 0); }
+    }
+    
+    .voice-options {
+        margin-top: 10px;
+        padding: 10px;
+        border-radius: 8px;
+        background-color: rgba(0, 0, 128, 0.05);
+    }
+    """
+    return css
+
+# ----------------- Login Form UI -----------------
+
+def login_form_ui():
+    with gr.Blocks() as login_form:
+         
+        # USIU logo
+         gr.HTML('''
+         <div class="logo-container">
+             <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+         </div>
+         ''')
+
+         gr.Markdown("## Please Login")
+         user_id_input = gr.Textbox(
+             placeholder="Enter your User ID", 
+             label="User ID", 
+             type="email", 
+             autofocus=True
+        )
+         # Error message for invalid user ID
+         user_id_error = gr.Markdown("", visible=True)
+         
+         password_input = gr.Textbox(
+             placeholder="Enter your Password", 
+             label="Password", 
+             type="password"
+        )
+         # Error message for invalid password
+         password_error = gr.Markdown("", visible=True)
+         
+         login_btn = gr.Button("Login")
+         # Error message for invalid credentials
+         login_msg = gr.Markdown("")
+         proceed_btn = gr.Button("Proceed", visible=False)
+         back_btn = gr.Button("Back to Dashboard")
+    # Return the login form along with the necessary components in order.
+    
+    return login_form, user_id_input, user_id_error, password_input, password_error, login_btn, login_msg, proceed_btn, back_btn
+
+# ----------------- Authentication Logic -----------------
+
+def show_success(message: str, duration: float = 10, visible: bool = True, title: str = "Success") -> None:
+    # Bright, material-style success colors:
+    styled_message = (
+        f'<span style="color: #2e7d32; background-color: #c8e6c9; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Success(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+def show_error(message: str, duration: float = 13, visible: bool = True, title: str = "Error") -> None:
+    # Bright, material-style error colors:
+    styled_message = (
+        f'<span style="color: #c62828; background-color: #ffcdd2; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Error(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+def handle_login(user_id, password):
+    """
+    Validates login fields and the User ID (which must end with '@usiu.ac.ke').
+    - If both fields are empty, a generic error modal is shown.
+    - If a specific field is empty, an error message for that field is returned.
+    - On successful authentication, a success modal pops up.
+    
+    Returns a tuple of five outputs:
+      1. Overall status message (displayed below the login button).
+      2. User ID field-specific error (displayed below the User ID input).
+      3. Password field-specific error (displayed below the Password input).
+      4. A gr.update() call to control the visibility of the "Proceed" button.
+      5. A gr.update() call to control the visibility of the "Login" button.
+    """
+    try:
+        user_id = user_id.strip() if user_id else ""
+        password = password.strip() if password else ""
+
+        # Both fields empty:
+        if user_id == "" and password == "":
+            show_error("Please enter your User ID and Password.")
+            return (
+                "<span style='color:#c62828;'>Please enter your User ID and Password.</span>",
+                "",   # No field-specific error for User ID.
+                "",   # No field-specific error for Password.
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        # User ID is empty:
+        elif user_id == "":
+            show_error("User ID is required.")
+            return (
+                "", 
+                "<span style='color:#c62828;'>User ID is required.</span>",
+                "",
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        # Password is empty:
+        elif password == "":
+            show_error("Password is required.")
+            return (
+                "",
+                "",
+                "<span style='color:#c62828;'>Password is required.</span>",
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        else:
+            # Validate the User ID: must end with "@usiu.ac.ke"
+            email_regex = r'^[\w\.-]+@usiu\.ac\.ke$'
+            if not re.match(email_regex, user_id):
+                show_error("User ID must be a valid \"@usiu.ac.ke\" email address.")
+                return (
+                    "",
+                    "<span style='color:#c62828;'>User ID must be a valid @usiu.ac.ke email address.</span>",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True)
+                )
+            # Attempt authentication.
+            if authenticate(user_id, password):
+                show_success("Login successful! Click 'Proceed' to continue!", duration=10)
+                return (
+                    "", 
+                    "",
+                    "",
+                    gr.update(visible=True), # Show Proceed button.
+                    gr.update(visible=False) # Hide Login button.
+                )
+            else:
+                show_error("Invalid credentials. Please try again.")
+                return (
+                    "<span style='color:#c62828;'>Invalid credentials. Please try again.</span>",
+                    "",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True)
+                )
+    except NameError as e:
+        show_error(f"System error: {str(e)}. Please ensure required modules are imported.")
+        return (
+            "<span style='color:#c62828;'>System error encountered.</span>",
+            "",
+            "",
+            gr.update(visible=False),
+            gr.update(visible=True)
+        )
+
+# ----------------- Voice Interaction Logic -----------------
+
+def voice_button_click():
+    """Callback for the voice input button"""
+    voice_interface.start_recording()
+    # Wait for up to 10 seconds for voice input
+    text = voice_interface.get_text_from_speech(timeout=10)
+    voice_interface.stop_recording()
+    return text if text else ""
+
+#############################
+# READ FILE UTILITY
+#############################
+def read_file(file):
+    file_extension = os.path.splitext(file.name)[1].lower()
+    
+    if file_extension == '.txt':
+        content = file.read().decode('utf-8')
+    elif file_extension == '.pdf':
+        pdf_reader = PyPDF2.PdfReader(file)
+        content = ''
+        for page in pdf_reader.pages:
+            text = page.extract_text()
+            if text:
+                content += text
+    elif file_extension in ['.docx', '.doc']:
+        doc = docx.Document(file)
+        content = "\n".join([para.text for para in doc.paragraphs])
+    elif file_extension in ['.xlsx', '.xls']:
+        df = pd.read_excel(file)
+        content = df.to_string()
+    elif file_extension in ['.pptx', '.ppt']:
+        prs = pptx.Presentation(file)
+        content = ''
+        for slide in prs.slides:
+            for shape in slide.shapes:
+                if hasattr(shape, 'text'):
+                    content += shape.text + '\n'
+    elif file_extension in ['.png', '.jpg', '.jpeg', '.gif']:
+        image = Image.open(file)
+        buffered = io.BytesIO()
+        image.save(buffered, format="PNG")
+        # Create an image variation via OpenAI's API (example)
+        response = openai.Image.create_variation(
+            image=buffered,
+            n=1,
+            size="256x256"
+        )
+        image_description = response['data'][0]['url']
+        content = f"[Image uploaded. Description: {image_description}]"
+    else:
+        content = f"Unsupported file type: {file_extension}"
+    
+    return content
+
+#############################
+# GLOBAL RETRIEVER SETUP (for RAG in general_chat_ui)
+#############################
+from vector_services.data_curator import DataCurator
+curator = DataCurator(knowledge_base_dir="usiu-knowledge-base")
+curator.load_vectorstore()
+# GLOBAL_RETRIEVER enables RAG for general chat.
+GLOBAL_RETRIEVER = curator.get_retriever()
+
+#############################
+# GENERAL CHAT UI (with RAG)
+#############################
+def general_chat_ui(system_prompt: str, model: str) -> None:
+    """
+    Creates a Gradio ChatInterface for general academic chat with voice capabilities.
+    """
+    def general_chat(message: str, chat_history, file, play_response=False) -> str:
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                ),
+                "files": []
+            }
+            chat_history.insert(0, conv_header)  # Insert at the beginning
+        
+        # Start with the initial system prompt.
+        messages = [
+            {"role": "system", "content": system_prompt, "files": []},
+        ]
+        
+        # Add chat history to messages (all messages, including header).
+        if chat_history:
+            # If the first element is a tuple/list with two elements, assume pair format.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human, "files": []})
+                    messages.append({"role": "assistant", "content": assistant, "files": []})
+            # Otherwise, if they are dicts, include all messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    # Skip header messages when sending to API.
+                    if msg.get("role") == "header":
+                        continue
+                    # Ensure each message has a files field.
+                    msg_to_send = dict(msg)
+                    if "files" not in msg_to_send or msg_to_send["files"] is None:
+                        msg_to_send["files"] = []
+                    messages.append(msg_to_send)
+        
+        # If a file is uploaded, add its content to the messages.
+        if file is not None:
+            try:
+                file_content = read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}",
+                    "files": []
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}",
+                    "files": []
+                })
+        
+        # RAG: Retrieve additional context using GLOBAL_RETRIEVER if available.
+        if GLOBAL_RETRIEVER is not None:
+            try:
+                docs = GLOBAL_RETRIEVER.get_relevant_documents(message)
+                if docs:
+                    context_text = "\n\n".join([doc.page_content for doc in docs])
+                    # Insert the retrieved context as an additional system message.
+                    messages.insert(1, {
+                        "role": "system",
+                        "content": f"Additional Context:\n{context_text}",
+                        "files": []
+                    })
+            except Exception as e:
+                print("RAG retrieval failed:", e)
+        
+        # Append the current user message to chat_history as a dictionary for consistency.
+        chat_history.append({"role": "user", "content": message, "files": []})
+        
+        # Also add the user message to the messages list (so it is sent to the API).
+        messages.append({"role": "user", "content": message, "files": []})
+        
+        print("General Enquiries - Conversation with context:")
+        print(messages)
+        
+        # Call OpenAI's ChatCompletion with streaming enabled.
+        completion = openai.ChatCompletion.create(
+            model=model,
+            messages=messages,
+            max_tokens=2_000,
+            temperature=0.7,
+            stream=True,
+        )
+        
+        response = ""
+        for chunk in completion:
+            token = chunk.choices[0].delta.get("content", "")
+            response += token
+            yield response
+
+        # After the response is completely generated, append a timestamp.
+        timestamp = time.strftime("%I:%M %p", time.localtime())
+        final_response = response + f"\n<span style='font-size:11px; color:#999;'>{timestamp}</span>"
+        
+        # If voice playback is enabled, read the response aloud in a separate thread
+        if play_response:
+            threading.Thread(
+                target=voice_interface.text_to_speech,
+                args=(response,),
+                daemon=True
+            ).start()
+        
+        yield final_response
+    
+    with gr.Blocks() as interface:
+        # Create the main chatbot UI
+        chatbot = gr.Chatbot(
+            [],
+            elem_id="general-chatbot",
+            avatar_images=(None, "https://i.imgur.com/KLhAVLW.png"),
+            bubble_full_width=False,
+            height=500
+        )
+        
+        with gr.Row():
+            with gr.Column(scale=10):
+                msg = gr.Textbox(
+                    show_label=False,
+                    placeholder="Type your message here...",
+                    container=False,
+                    lines=1
+                )
+            with gr.Column(scale=1, min_width=50):
+                voice_input_btn = gr.Button("🎤", elem_classes="voice-btn")
+            with gr.Column(scale=1, min_width=60):
+                send_btn = gr.Button("Send")
+        
+        with gr.Accordion("Additional Options", open=False, elem_classes="additional-inputs-accordion"):
+            with gr.Row():
+                file_upload = gr.File(label="Upload a file (optional)", elem_classes="file-upload", scale=2)
+                voice_output = gr.Checkbox(label="Enable Voice Responses", value=False, scale=1, elem_classes="voice-options")
+        
+        # Set up event handlers
+        voice_input_btn.click(
+            voice_button_click,
+            outputs=[msg]
+        )
+        
+        msg.submit(
+            general_chat,
+            [msg, chatbot, file_upload, voice_output],
+            [chatbot]
+        ).then(
+            lambda: "", None, [msg]
+        )
+        
+        send_btn.click(
+            general_chat,
+            [msg, chatbot, file_upload, voice_output],
+            [chatbot]
+        ).then(
+            lambda: "", None, [msg]
+        )
+        
+        # Add JavaScript for voice button behavior
+        gr.HTML("""
+        <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            // Find voice button after a delay to ensure it's loaded
+            setTimeout(function() {
+                const voiceBtn = document.querySelector('.voice-btn');
+                if (voiceBtn) {
+                    voiceBtn.addEventListener('click', function() {
+                        this.classList.add('recording');
+                        
+                        // Remove recording class after 10 seconds (max recording time)
+                        setTimeout(() => {
+                            this.classList.remove('recording');
+                        }, 10000);
+                    });
+                }
+            }, 2000);
+        });
+        </script>
+        """)
+    
+    return interface
+
+#############################
+# STUDY SUPPORT UI (without RAG)
+#############################
+def study_support_ui(system_prompt: str, model: str) -> None:
+    """
+    Creates a Gradio interface for study support with voice capabilities.
+    """
+    def study_support_chat(message: str, chat_history, file, play_response=False) -> str:
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                )
+            }
+            chat_history.insert(0, conv_header)
+
+        # Build the messages list that will be sent to the API.
+        messages = []
+        if chat_history:
+            # If chat_history items are tuples/lists with two elements, unpack them.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human})
+                    messages.append({"role": "assistant", "content": assistant})
+            # Otherwise, if they are dicts, include only "role" and "content" for non-system messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    if msg.get("role") == "header":
+                        continue  # Skip header messages.
+                    msg_to_send = {"role": msg.get("role"), "content": msg.get("content")}
+                    messages.append(msg_to_send)
+        
+        # Add the current message.
+        messages.append({"role": "user", "content": message})
+        
+        # If a file is uploaded, add its content.
+        if file is not None:
+            try:
+                file_content = read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}"
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}"
+                })
+        
+        # Add current user message to chat history for display
+        chat_history.append({"role": "user", "content": message})
+        
+        # Implement a retry mechanism to handle overloaded errors.
+        max_retries = 7
+        delay = 3  # seconds
+        attempt = 0
+        
+        while attempt < max_retries:
+            try:
+                result = claude.messages.stream(
+                    model=model,
+                    max_tokens=64_000,
+                    system=system_prompt,
+                    messages=messages,
+                    extra_query={"extended_thinking": True}
+                )
+                response = ""
+                with result as stream:
+                    for text in stream.text_stream:
+                        response += text
+                        yield response  # Yield incremental responses.
+                
+                # After the response is completely generated, append a timestamp.
+                timestamp = time.strftime("%I:%M %p", time.localtime())
+                final_response = response + f"\n<span style='font-size:11px; color:#999;'>{timestamp}</span>"
+                
+                # If voice playback is enabled, read the response aloud in a separate thread
+                if play_response:
+                    threading.Thread(
+                        target=voice_interface.text_to_speech,
+                        args=(response,),
+                        daemon=True
+                    ).start()
+                
+                yield final_response
+                break  # Exit the retry loop if successful.
+            except Exception as e:
+                # Check if error indicates the API is overloaded.
+                if "overloaded" in str(e).lower():
+                    attempt += 1
+                    yield f"Service unavailable. Retrying in {delay} seconds... (attempt {attempt}/{max_retries})\n"
+                    time.sleep(delay)
+                else:
+                    print(f"An error occurred: {str(e)}")
+                    break
+        else:
+            yield "The service is currently unavailable. Please try again later."
+    
+    with gr.Blocks() as interface:
+        # Create the main chatbot UI
+        chatbot = gr.Chatbot(
+            [],
+            elem_id="study-chatbot",
+            avatar_images=(None, "https://i.imgur.com/KLhAVLW.png"),
+            bubble_full_width=False,
+            height=500
+        )
+        
+        with gr.Row():
+            with gr.Column(scale=10):
+                msg = gr.Textbox(
+                    show_label=False,
+                    placeholder="Type your message here...",
+                    container=False,
+                    lines=1
+                )
+            with gr.Column(scale=1, min_width=50):
+                voice_input_btn = gr.Button("🎤", elem_classes="voice-btn")
+            with gr.Column(scale=1, min_width=60):
+                send_btn = gr.Button("Send")
+        
+        with gr.Accordion("Additional Options", open=False, elem_classes="additional-inputs-accordion"):
+            with gr.Row():
+                file_upload = gr.File(label="Upload a file (optional)", elem_classes="file-upload", scale=2)
+                voice_output = gr.Checkbox(label="Enable Voice Responses", value=False, scale=1, elem_classes="voice-options")
+        
+        # Set up event handlers
+        voice_input_btn.click(
+            voice_button_click,
+            outputs=[msg]
+        )
+        
+        msg.submit(
+            study_support_chat,
+            [msg, chatbot, file_upload, voice_output],
+            [chatbot]
+        ).then(
+            lambda: "", None, [msg]
+        )
+        
+        send_btn.click(
+            study_support_chat,
+            [msg, chatbot, file_upload, voice_output],
+            [chatbot]
+        ).then(
+            lambda: "", None, [msg]
+        )
+        
+        # Add JavaScript for voice button behavior
+        gr.HTML("""
+        <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            // Find voice button after a delay to ensure it's loaded
+            setTimeout(function() {
+                const voiceBtn = document.querySelector('#study-chatbot + div .voice-btn');
+                if (voiceBtn) {
+                    voiceBtn.addEventListener('click', function() {
+                        this.classList.add('recording');
+                        
+                        // Remove recording class after 10 seconds (max recording time)
+                        setTimeout(() => {
+                            this.classList.remove('recording');
+                        }, 10000);
+                    });
+                }
+            }, 2000);
+        });
+        </script>
+        """)
+    
+    return interface
+
+# ---------- Dashboard UI ----------
+def dashboard_ui(general_chat_prompt: str, general_model: str, study_prompt: str, study_model: str):
+    """
+    Creates a dashboard with professional styling, two main menus (General Chat and Study Support),
+    and smooth transitions between views. For Study Support, a login form (with authentication)
+    is shown before revealing the chat interface.
+    """
+    # Retrieve the existing chat interfaces.
+    general_chat_component = general_chat_ui(general_chat_prompt, general_model)
+    study_support_component = study_support_ui(study_prompt, study_model)
+    # Retrieve the login form.
+    (login_form_component, user_id_input, user_id_error, password_input, password_error,
+     login_btn, login_msg, proceed_btn, login_back_btn) = login_form_ui()
+    
+    with gr.Blocks(css=custom_css()) as dashboard:
+        # Inject JavaScript for animations and loading effects
+        gr.HTML('''
+        <script>
+        document.addEventListener("DOMContentLoaded", function() {
+            // Create and style the spinner element
+            let spinner = document.createElement("div");
+            spinner.className = "loader";
+            spinner.innerHTML = '<div class="cube"></div>';
+            document.body.appendChild(spinner);
+                
+            // Show the spinner when needed
+            spinner.style.display = "none";  // Initially hidden
+            
+            // Function to show spinner
+            function showSpinner() {
+                spinner.style.display = "block";
+            }
+            
+            // Function to hide spinner
+            function hideSpinner() {
+                spinner.style.display = "none";
+            }
+            
+            // Function to handle animation transitions
+            function setupAnimations() {
+                // Get all containers that might be animated
+                const containers = document.querySelectorAll('.container, .chat-container');
+                
+                // Add transition end listener to each container
+                containers.forEach(container => {
+                    container.addEventListener('animationend', function(e) {
+                        // When animation completes, remove the animation class
+                        if (e.animationName.includes('fadeIn')) {
+                            this.classList.remove('animate-fadeInUp', 'animate-fadeInRight', 'animate-fadeInLeft');
+                        }
+                    });
+                });
+            }
+            
+            // Setup animations after a short delay to ensure DOM is ready
+            setTimeout(setupAnimations, 2000);
+
+            // Add event listeners to all buttons that should trigger the spinner
+            setTimeout(function(){
+                // Login and Proceed buttons with spinner
+                const loginBtn = document.querySelector('button:contains("Login")');
+                const proceedBtn = document.querySelector('button:contains("Proceed")');
+                
+                if (loginBtn) {
+                    loginBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when login button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                if (proceedBtn) {
+                    proceedBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when proceed button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                // Scale effect for dashboard buttons
+                const dashboardButtons = document.querySelectorAll('.menu-button, button:contains("Back to Dashboard")');
+                dashboardButtons.forEach(function(btn) {
+                    btn.addEventListener("click", function() {
+                        this.style.transform = "scale(1.1)";
+                        setTimeout(() => {
+                            this.style.transform = "";
+                        }, 200);
+                    });
+                });
+            }, 2000);
+            
+            // Add keyframes for spinner animation
+            const style = document.createElement('style');
+            style.textContent = `
+                @keyframes spin {
+                    0% { transform: rotate(0deg); }
+                    100% { transform: rotate(360deg); }
+                }
+            `;
+            document.head.appendChild(style);
+        });
+        </script>
+        ''')
+
+        # Logo for all pages - positioned in top-left corner
+        gr.HTML('''
+        <div class="logo-dashboard">
+            <!-- USIU Logo Placeholder - Replace the src with actual logo path -->
+            <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+        </div>
+        ''')
+
+        # Define containers for different views with initial animation state
+        dashboard_container = gr.Column(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInUp")
+        general_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        login_container = gr.Column(visible=False, elem_classes="container floating-card login-form-container pre-animation")
+        study_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        
+        # ------------- Dashboard View -------------
+        with dashboard_container:
+            gr.Markdown("<h1 class='with-logo'>AI Assistance Dashboard</h1>")
+            with gr.Column(elem_classes="dashboard-menu"):
+                gen_button = gr.Button("General Enquiries", elem_classes="menu-button")
+                study_button = gr.Button("Study with AI", elem_classes="menu-button")
+        
+        # ------------- General Academic Chat View -------------
+        with general_container:
+            back_gen = gr.Button("Back to Dashboard")
+            general_chat_component.render()
+        
+        # ------------- Login Form (for Study Support) View -------------
+        with login_container:
+            login_form_component.render()
+        
+        # ------------- Study Support Chat View -------------
+        with study_container:
+            back_study = gr.Button("Back to Dashboard")
+            study_support_component.render()
+        
+        # ------------- Navigation Callbacks -------------
+        # When "General Academic Chat" is selected from the dashboard.
+        gen_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # When "Study Support Chat" is selected from the dashboard, show the login view with animation.
+        study_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=True, elem_classes="container floating-card login-form-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # "Back to Dashboard" buttons with animation.
+        back_gen.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        back_study.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        login_back_btn.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # ------------- Authentication Logic -------------
+        # ------------- Authentication Logic -------------
+        login_btn.click(
+            handle_login,
+            inputs=[user_id_input, password_input],
+            outputs=[login_msg, user_id_error, password_error, proceed_btn, login_btn]
+        )
+        
+        proceed_btn.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # Register the cleanup function to run when the program exits
+        import atexit
+        atexit.register(voice_interface.cleanup)
+    
+    return dashboard.queue()

services/ui_service-old3.py

@@ -0,0 +1,1527 @@
+import re
+import os
+import time
+import openai
+import gradio as gr
+import PyPDF2
+import docx
+import pandas as pd
+import pptx
+from PIL import Image
+import io
+import base64
+
+from configs.config import claude
+from .auth_service import authenticate
+
+
+# Set the OpenAI API key from the environment variable
+openai.api_key = os.getenv('OPENAI_API_KEY')
+if not openai.api_key:
+    raise ValueError("OPENAI_API_KEY environment variable is not set. Please set it before running this script.")
+
+def custom_css():
+    css = """
+    /* Professional custom CSS with transitions, hover effects, and responsive design */
+    body { 
+        font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; 
+        background-color: #f8f9fa; 
+        margin: 0; 
+        padding: 0;
+        width: 100%;
+        overflow-x: hidden; /* Prevent horizontal scrolling */
+    }
+    h1, h2, h3 { 
+        text-align: center; 
+        color: #495057;
+    }
+    .gr-button { 
+        transition: background-color 0.3s ease, transform 0.3s ease; 
+        border-radius: 4px;
+        /* USIU-Africa theme color for buttons */
+        background-color: #000080;
+        color: white;
+    }
+    .gr-button:hover { 
+        background-color: #000066; 
+        color: #fff; 
+        transform: scale(1.03);
+    }
+    .container { 
+        transition: opacity 0.5s ease-in-out;
+        padding: 4px;
+    }
+
+    /* Glassmorphism effect for floating cards */
+    .floating-card {
+        background: rgba(255, 255, 255, 0.85);
+        border-radius: 12px;
+        box-shadow: 
+            0 10px 25px rgba(0,0,0,0.08),
+            0 6px 10px rgba(0,0,0,0.12),
+            0 3px 3px rgba(0,0,0,0.15);
+        transition: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
+        padding: 25px;
+        margin: 15px auto; /* Reduced margin */
+        backdrop-filter: blur(10px);
+        border: 1px solid rgba(255,255,255,0.25);
+        width: 95%; /* Increased width */
+        max-width: 98%; /* Increased max-width */
+    }
+
+    .floating-card:hover {
+        box-shadow: 
+            0 15px 30px rgba(0,0,0,0.15),
+            0 10px 10px rgba(0,0,0,0.18);
+        transform: translateY(-5px);
+        background: rgba(255, 255, 255, 0.9);
+    }
+
+    /* Login form styling with responsiveness */
+    .login-form-container {
+        width: 98% !important; /* Increased width for mobile */
+        max-width: 500px !important;
+        margin: 30px auto !important; /* Reduced top/bottom margin */
+        background: rgba(255, 255, 255, 0.88) !important;
+        backdrop-filter: blur(12px) !important;
+        border: 1px solid rgba(255, 255, 255, 0.3) !important;
+        border-top: 3px solid #000080 !important;
+        padding: 20px 15px !important; /* Added horizontal padding */
+    }
+
+    /* Dashboard container styling with responsiveness */
+    .dashboard-card {
+        width: 98% !important; /* Take almost full width on mobile */
+        max-width: 700px !important;
+        margin: 20px auto !important; /* Reduced margin */
+        background: rgba(255, 255, 255, 0.88) !important;
+        backdrop-filter: blur(12px) !important;
+        height: auto !important;
+        min-height: 500px !important;
+        border: 1px solid rgba(255, 255, 255, 0.3) !important;
+        border-top: 3px solid #000080 !important;
+        opacity: 0;
+        animation: dashboardFadeIn 1.5s forwards ease-in-out;
+        padding: 20px 10px !important; /* Reduced horizontal padding */
+    }
+
+    /* A subtle gradient background to the cards */
+    .dashboard-card, .login-form-container {
+        background: linear-gradient(
+            135deg, 
+            rgba(255, 255, 255, 0.9) 0%, 
+            rgba(255, 255, 255, 0.8) 100%
+        ) !important;
+    }
+
+    /* Logo container styling with responsive adjustments */
+    .logo-container {
+        text-align: center;
+        margin-bottom: 25px;
+        position: relative;
+        width: 100%;
+    }
+
+    .logo {
+        max-height: 80px;
+        max-width: 90%; /* Increased max-width */
+        margin: 0 auto;
+        display: block;
+    }
+
+    .logo-dashboard {
+        position: absolute;
+        top: 15px;
+        left: 15px;
+        max-height: 60px;
+        max-width: 35%; /* Increased max-width */
+        z-index: 100;
+        opacity: 0;
+        animation: logoFadeIn 1.8s forwards ease-in-out;
+    }
+
+    .with-logo {
+        margin-top: 10px;
+    }
+
+    /* Chat UI container with extended width and responsiveness */
+    .chat-container {
+        max-width: 1000px;
+        width: 98%; /* Increased width for mobile */
+        margin: 0 auto;
+        opacity: 0;
+        transform: translateY(20px);
+        animation: fadeInUp 0.7s forwards;
+    }
+
+    /* Increase chat window height with responsive adjustment */
+    .chatbot-container, .gradio-container .chat {
+        height: 80vh !important;
+        max-height: 900px !important;
+        width: 98% !important; /* Take up more width */
+        margin: 0 auto !important;
+    }
+    
+    /* Make Gradio container take full width on mobile */
+    .gradio-container {
+        width: 100% !important;
+        max-width: 100% !important;
+        margin: 0 !important;
+        padding: 0 !important;
+    }
+    
+    /* File input adjustment - restore default styling */
+    .file-upload .p-2 {
+        padding: inherit !important;
+    }
+    
+    /* Accordion button adjustment - remove forced padding to restore default behavior */
+    .accordion-button {
+        padding: inherit !important;
+    }
+    
+    /* Fix for accordion collapsed state */
+    .accordion-button.collapsed {
+        /* Reset any custom styles when collapsed */
+        padding: initial !important;
+        height: auto !important;
+        min-height: initial !important;
+    }
+    
+    /* Allow accordion and file input to use Gradio's default styling */
+    .file-upload, .accordion {
+        /* Restore default Gradio styling */
+        margin: initial !important;
+        padding: initial !important;
+    }
+
+    /* Restore default styling for chat action buttons (clear, retry, undo) */
+    .chat-buttons button, 
+    .chat-buttons .gr-button,
+    button[aria-label="Clear"],
+    button[aria-label="Retry"],
+    button[aria-label="Undo"] {
+        padding: initial !important;
+        height: auto !important;
+        min-height: initial !important;
+        width: auto !important;
+        min-width: initial !important;
+        background-color: initial !important;
+        color: initial !important;
+        transform: none !important;
+    }
+
+    /* Hover effect for chat buttons */
+    .chat-buttons button:hover, 
+    .chat-buttons .gr-button:hover,
+    button[aria-label="Clear"]:hover,
+    button[aria-label="Retry"]:hover,
+    button[aria-label="Undo"]:hover {
+        transform: none !important;
+        background-color: initial !important;
+        background-image: none !important;
+    }
+
+    /* Dashboard menu buttons styling with responsiveness */
+    .dashboard-menu {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        min-height: 60vh;
+        gap: 8px;
+        opacity: 0;
+        animation: menuFadeIn 3s forwards ease-in-out;
+        animation-delay: 0.7s;
+        padding: 15px 0; /* Reduced padding */
+        width: 100%; /* Full width */
+    }
+
+    .menu-button {
+        width: 95% !important; /* Increased width for mobile */
+        max-width: 300px !important;
+        height: auto !important;
+        min-height: 60px !important;
+        font-size: 16px !important;
+        font-weight: 500 !important;
+        margin: 6px auto !important; /* Reduced margin */
+        border-radius: 8px !important;
+        box-shadow: 0 2px 5px rgba(0,0,0,0.1) !important;
+        transition: transform 0.3s ease, box-shadow 0.3s ease !important;
+        background-color: #000080 !important;
+        color: white !important;
+        opacity: 0;
+        animation: buttonsFadeIn 0.7s forwards ease-in-out;
+        animation-delay: calc(var(--button-index, 0) * 0.3s + 1s);
+        padding: 10px 15px !important;
+        display: flex !important;
+        align-items: center !important;
+        justify-content: center !important;
+        text-align: center !important;
+        word-wrap: break-word !important;
+    }
+
+    .menu-button:hover {
+        transform: scale(1.02);
+        background-image: linear-gradient(to bottom right, #000080, #0000cc);
+        transition: transform 0.5s ease;
+        box-shadow: 0 4px 8px rgba(0,0,0,0.2) !important;
+    }
+
+    /* 3D Loader CSS with responsive sizing */
+    .loader {
+        width: 40px; /* Reduced size */
+        height: 40px; /* Reduced size */
+        perspective: 100px;
+        position: fixed;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        z-index: 9999;
+        display: none;
+    }
+    .cube {
+        width: 100%;
+        height: 100%;
+        background: #000080;
+        transform: rotateX(0deg) rotateY(0deg);
+        animation: spinCube 1.5s infinite ease-in-out;
+    }
+    @keyframes spinCube {
+        0%   { transform: rotateX(0deg) rotateY(0deg); }
+        25%  { transform: rotateX(90deg) rotateY(0deg); }
+        50%  { transform: rotateX(90deg) rotateY(90deg); }
+        75%  { transform: rotateX(0deg) rotateY(90deg); }
+        100% { transform: rotateX(0deg) rotateY(0deg); }
+    }
+    
+    /* Dashboard specific fade-in animations */
+    @keyframes dashboardFadeIn {
+        0% {
+            opacity: 0;
+            transform: translateY(30px);
+        }
+        100% {
+            opacity: 1;
+            transform: translateY(0);
+        }
+    }
+    
+    @keyframes logoFadeIn {
+        0% {
+            opacity: 0;
+            transform: translateY(-20px);
+        }
+        100% {
+            opacity: 1;
+            transform: translateY(0);
+        }
+    }
+    
+    @keyframes menuFadeIn {
+        0% {
+            opacity: 0;
+            transform: scale(0.95);
+        }
+        100% {
+            opacity: 1;
+            transform: scale(1);
+        }
+    }
+    
+    @keyframes buttonsFadeIn {
+        0% {
+            opacity: 0;
+            transform: translateX(-15px);
+        }
+        100% {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    /* Adding transition effects for interfaces */
+    @keyframes fadeInUp {
+        from {
+            opacity: 0;
+            transform: translateY(20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateY(0);
+        }
+    }
+
+    @keyframes fadeInRight {
+        from {
+            opacity: 0;
+            transform: translateX(20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    @keyframes fadeInLeft {
+        from {
+            opacity: 0;
+            transform: translateX(-20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    /* Container animation classes that can be dynamically applied */
+    .animate-fadeInUp {
+        animation: fadeInUp 0.7s forwards;
+    }
+
+    .animate-fadeInRight {
+        animation: fadeInRight 0.7s forwards;
+    }
+
+    .animate-fadeInLeft {
+        animation: fadeInLeft 0.7s forwards;
+    }
+
+    /* Initial state for containers to be animated */
+    .pre-animation {
+        opacity: 0;
+    }
+
+    /* Specifically target Gradio elements to make them more mobile-friendly */
+    .gradio-container {
+        margin-left: 0 !important;
+        margin-right: 0 !important;
+    }
+    
+    /* Adjust textbox and button widths for mobile */
+    .gr-textbox {
+        width: 100% !important;
+    }
+    
+    .gr-button-primary {
+        width: 100% !important;
+        margin: 5px 0 !important;
+    }
+    
+    /* Make all interface elements take more width on mobile */
+    .interface-elements {
+        width: 98% !important;
+        max-width: 100% !important;
+        margin: 0 auto !important;
+    }
+    
+    /* Fix padding for form elements */
+    input, select, textarea, button {
+        box-sizing: border-box !important;
+    }
+
+    /* Ensure accordion, file inputs, and chat buttons are not affected by button min-height */
+    .accordion-button, 
+    .file-upload button,
+    .chat-buttons button,
+    button[aria-label="Clear"],
+    button[aria-label="Retry"],
+    button[aria-label="Undo"] {
+        min-height: auto !important;
+    }
+
+    /* Media Queries for better responsiveness */
+    @media screen and (max-width: 768px) {
+        body {
+            padding: 0 !important; /* Remove body padding on mobile */
+        }
+        
+        .dashboard-card {
+            width: 100% !important; /* Full width */
+            padding: 15px 8px !important; /* Reduced padding */
+            margin: 10px auto !important; /* Reduced margin */
+            border-radius: 0 !important; /* Optional: Remove border radius for full-width look */
+        }
+        
+        .login-form-container {
+            width: 100% !important; /* Full width */
+            padding: 15px 10px !important; /* Reduced padding */
+            margin: 10px auto !important; /* Reduced margin */
+            border-radius: 0 !important; /* Optional: Remove border radius for full-width look */
+        }
+        
+        .menu-button {
+            width: 98% !important; /* Almost full width */
+            font-size: 14px !important;
+            min-height: 50px !important;
+        }
+        
+        .logo-dashboard {
+            max-height: 40px;
+            top: 10px;
+            left: 10px;
+        }
+        
+        h1 {
+            font-size: 1.5rem !important;
+            margin-top: 10px !important;
+            margin-bottom: 15px !important;
+        }
+        
+        h2 {
+            font-size: 1.3rem !important;
+            margin-top: 8px !important;
+            margin-bottom: 12px !important;
+        }
+        
+        h3 {
+            font-size: 1.1rem !important;
+            margin-top: 6px !important;
+            margin-bottom: 10px !important;
+        }
+        
+        /* Make chat interface take full width */
+        .chat-container, .chatbot-container {
+            width: 100% !important;
+            margin: 0 !important;
+            padding: 0 5px !important;
+        }
+        
+        /* Adjust Gradio containers */
+        .gradio-container {
+            padding: 0 !important;
+        }
+    }
+
+    @media screen and (max-width: 480px) {
+        .dashboard-card {
+            padding: 10px 5px !important; /* Further reduced padding */
+            margin: 0 auto !important; /* Remove margin completely */
+            border-radius: 0 !important; /* Remove border radius */
+            width: 100% !important; /* Full width */
+        }
+        
+        .login-form-container {
+            padding: 10px 5px !important; /* Further reduced padding */
+            margin: 0 auto !important; /* Remove margin completely */
+            border-radius: 0 !important; /* Remove border radius */
+            width: 100% !important; /* Full width */
+        }
+        
+        .menu-button {
+            font-size: 13px !important;
+            min-height: 45px !important;
+            margin: 5px auto !important;
+            width: 100% !important; /* Full width */
+            border-radius: 6px !important; /* Slightly reduced border radius */
+        }
+        
+        .logo-dashboard {
+            max-height: 35px;
+            top: 5px;
+            left: 5px;
+        }
+        
+        /* Adjust spacing in forms for mobile */
+        input, select, textarea {
+            margin-bottom: 8px !important;
+            padding: 8px !important;
+            width: 100% !important;
+        }
+        
+        /* Reduce padding and margins for all content */
+        .floating-card, .gr-box, .gr-panel {
+            padding: 10px 5px !important;
+            margin: 5px 0 !important;
+            width: 100% !important;
+        }
+        
+        /* Full width for all UI components */
+        .gr-form, .gr-input, .gr-button, .gr-box {
+            width: 100% !important;
+            margin-left: 0 !important;
+            margin-right: 0 !important;
+        }
+    }
+
+    /* Additional responsive handling for extreme screen sizes */
+    @media screen and (max-width: 320px) {
+        /* For very small screens like older iPhones */
+        .menu-button {
+            font-size: 11px !important;
+            min-height: 40px !important;
+            padding: 8px 5px !important;
+        }
+        
+        .dashboard-card {
+            padding: 5px 3px !important;
+        }
+        
+        h1 {
+            font-size: 1.3rem !important;
+        }
+        
+        h2 {
+            font-size: 1.1rem !important;
+        }
+        
+        h3 {
+            font-size: 1rem !important;
+        }
+    }
+
+    @media screen and (min-width: 1600px) {
+        /* For very large screens */
+        .dashboard-card {
+            max-width: 1000px !important;
+        }
+        
+        .menu-button {
+            max-width: 400px !important;
+        }
+    }
+
+    /* For landscape orientation on mobile */
+    @media screen and (max-height: 500px) and (orientation: landscape) {
+        .dashboard-menu {
+            min-height: auto;
+            padding: 5px 0;
+        }
+        
+        .dashboard-card {
+            min-height: 300px !important;
+        }
+        
+        .menu-button {
+            min-height: 40px !important;
+            margin: 4px auto !important;
+        }
+    }
+    
+    /* Fixed positions for mobile views */
+    .fixed-top {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        z-index: 1000;
+    }
+    
+    .fixed-bottom {
+        position: fixed;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        z-index: 1000;
+    }
+    
+    /* Ensure minimum touch target size for all clickable elements 
+       BUT exclude accordion, file input, and chat action buttons */
+    button:not(.accordion-button):not(.file-upload button):not([aria-label="Clear"]):not([aria-label="Retry"]):not([aria-label="Undo"]):not(.chat-buttons button), 
+    .gr-button:not(.file-upload .gr-button):not(.chat-buttons .gr-button), 
+    a, 
+    input[type="submit"], 
+    input[type="button"] {
+        min-height: 44px !important; /* Apple's recommended minimum touch target size */
+        min-width: 44px !important;
+    }
+    
+    /* Remove any unnecessary margins from Gradio components */
+    .gradio-container .gr-form > *, .gradio-container .gr-group > * {
+        margin-bottom: 8px !important;
+    }
+    
+    /* Ensure Gradio container does not exceed viewport width */
+    #component-0, #component-1, #component-2, #component-3, #component-4, #component-5,
+    #component-6, #component-7, #component-8, #component-9, #component-10 {
+        max-width: 100vw !important;
+        overflow-x: hidden !important;
+    }
+    """
+    return css
+
+# ----------------- Login Form UI -----------------
+
+def login_form_ui():
+    with gr.Blocks() as login_form:
+         
+        # USIU logo
+         gr.HTML('''
+         <div class="logo-container">
+             <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+         </div>
+         ''')
+
+         gr.Markdown("## Please Login")
+         user_id_input = gr.Textbox(
+             placeholder="Enter your User ID", 
+             label="User ID", 
+             type="email", 
+             autofocus=True
+        )
+         # Error message for invalid user ID
+         user_id_error = gr.Markdown("", visible=True)
+         
+         password_input = gr.Textbox(
+             placeholder="Enter your Password", 
+             label="Password", 
+             type="password"
+        )
+         # Error message for invalid password
+         password_error = gr.Markdown("", visible=True)
+         
+         login_btn = gr.Button("Login")
+         # Error message for invalid credentials
+         login_msg = gr.Markdown("")
+         proceed_btn = gr.Button("Proceed", visible=False)
+         back_btn = gr.Button("Back to Dashboard")
+    # Return the login form along with the necessary components in order.
+    return login_form, user_id_input, user_id_error, password_input, password_error, login_btn, login_msg, proceed_btn, back_btn
+
+# ----------------- Authentication Logic -----------------
+
+def show_success(message: str, duration: float = 10, visible: bool = True, title: str = "Success") -> None:
+    # Bright, material-style success colors:
+    styled_message = (
+        f'<span style="color: #2e7d32; background-color: #c8e6c9; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Success(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+def show_error(message: str, duration: float = 13, visible: bool = True, title: str = "Error") -> None:
+    # Bright, material-style error colors:
+    styled_message = (
+        f'<span style="color: #c62828; background-color: #ffcdd2; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Error(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+def handle_login(user_id, password):
+    """
+    Validates login fields and the User ID (which must end with '@usiu.ac.ke').
+    - If both fields are empty, a generic error modal is shown.
+    - If a specific field is empty, an error message for that field is returned.
+    - On successful authentication, a success modal pops up.
+    
+    Returns a tuple of five outputs:
+      1. Overall status message (displayed below the login button).
+      2. User ID field-specific error (displayed below the User ID input).
+      3. Password field-specific error (displayed below the Password input).
+      4. A gr.update() call to control the visibility of the "Proceed" button.
+      5. A gr.update() call to control the visibility of the "Login" button.
+    """
+    try:
+        user_id = user_id.strip() if user_id else ""
+        password = password.strip() if password else ""
+
+        # Both fields empty:
+        if user_id == "" and password == "":
+            show_error("Please enter your User ID and Password.")
+            return (
+                "<span style='color:#c62828;'>Please enter your User ID and Password.</span>",
+                "",   # No field-specific error for User ID.
+                "",   # No field-specific error for Password.
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        # User ID is empty:
+        elif user_id == "":
+            show_error("User ID is required.")
+            return (
+                "", 
+                "<span style='color:#c62828;'>User ID is required.</span>",
+                "",
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        # Password is empty:
+        elif password == "":
+            show_error("Password is required.")
+            return (
+                "",
+                "",
+                "<span style='color:#c62828;'>Password is required.</span>",
+                gr.update(visible=False),
+                gr.update(visible=True)
+            )
+        else:
+            # Validate the User ID: must end with "@usiu.ac.ke"
+            email_regex = r'^[\w\.-]+@usiu\.ac\.ke$'
+            if not re.match(email_regex, user_id):
+                show_error("User ID must be a valid \"@usiu.ac.ke\" email address.")
+                return (
+                    "",
+                    "<span style='color:#c62828;'>User ID must be a valid @usiu.ac.ke email address.</span>",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True)
+                )
+            # Attempt authentication.
+            if authenticate(user_id, password):
+                show_success("Login successful! Click 'Proceed' to continue!", duration=10)
+                return (
+                    "", 
+                    "",
+                    "",
+                    gr.update(visible=True), # Show Proceed button.
+                    gr.update(visible=False) # Hide Login button.
+                )
+            else:
+                show_error("Invalid credentials. Please try again.")
+                return (
+                    "<span style='color:#c62828;'>Invalid credentials. Please try again.</span>",
+                    "",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True)
+                )
+    except NameError as e:
+        show_error(f"System error: {str(e)}. Please ensure required modules are imported.")
+        return (
+            "<span style='color:#c62828;'>System error encountered.</span>",
+            "",
+            "",
+            gr.update(visible=False),
+            gr.update(visible=True)
+        )
+
+# ---------- Dashboard UI ----------
+def dashboard_ui(general_chat_prompt: str, general_model: str, study_prompt: str, study_model: str):
+    """
+    Creates a dashboard with professional styling, two main menus (General Chat and Study Support),
+    and smooth transitions between views. For Study Support, a login form (with authentication)
+    is shown before revealing the chat interface.
+    """
+    # Retrieve the existing chat interfaces.
+    general_chat_component = general_chat_ui(general_chat_prompt, general_model)
+    study_support_component = study_support_ui(study_prompt, study_model)
+    # Retrieve the login form.
+    (login_form_component, user_id_input, user_id_error, password_input, password_error,
+     login_btn, login_msg, proceed_btn, login_back_btn) = login_form_ui()
+    
+    with gr.Blocks(css=custom_css()) as dashboard:
+        # Inject JavaScript for animations and loading effects
+        gr.HTML('''
+        <script>
+        document.addEventListener("DOMContentLoaded", function() {
+            // Create and style the spinner element
+            let spinner = document.createElement("div");
+            spinner.className = "loader";
+            spinner.innerHTML = '<div class="cube"></div>';
+            document.body.appendChild(spinner);
+                
+            // Show the spinner when needed
+            spinner.style.display = "none";  // Initially hidden
+            
+            // Function to show spinner
+            function showSpinner() {
+                spinner.style.display = "block";
+            }
+            
+            // Function to hide spinner
+            function hideSpinner() {
+                spinner.style.display = "none";
+            }
+            
+            // Function to handle animation transitions
+            function setupAnimations() {
+                // Get all containers that might be animated
+                const containers = document.querySelectorAll('.container, .chat-container');
+                
+                // Add transition end listener to each container
+                containers.forEach(container => {
+                    container.addEventListener('animationend', function(e) {
+                        // When animation completes, remove the animation class
+                        if (e.animationName.includes('fadeIn')) {
+                            this.classList.remove('animate-fadeInUp', 'animate-fadeInRight', 'animate-fadeInLeft');
+                        }
+                    });
+                });
+            }
+            
+            // Setup animations after a short delay to ensure DOM is ready
+            setTimeout(setupAnimations, 2000);
+
+            // Add event listeners to all buttons that should trigger the spinner
+            setTimeout(function(){
+                // Login and Proceed buttons with spinner
+                const loginBtn = document.querySelector('button:contains("Login")');
+                const proceedBtn = document.querySelector('button:contains("Proceed")');
+                
+                if (loginBtn) {
+                    loginBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when login button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                if (proceedBtn) {
+                    proceedBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when proceed button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                // Scale effect for dashboard buttons
+                const dashboardButtons = document.querySelectorAll('.menu-button, button:contains("Back to Dashboard")');
+                dashboardButtons.forEach(function(btn) {
+                    btn.addEventListener("click", function() {
+                        this.style.transform = "scale(1.1)";
+                        setTimeout(() => {
+                            this.style.transform = "";
+                        }, 200);
+                    });
+                });
+            }, 2000);
+            
+            // Add keyframes for spinner animation
+            const style = document.createElement('style');
+            style.textContent = `
+                @keyframes spin {
+                    0% { transform: rotate(0deg); }
+                    100% { transform: rotate(360deg); }
+                }
+            `;
+            document.head.appendChild(style);
+        });
+        </script>
+        ''')
+
+        # Logo for all pages - positioned in top-left corner
+        gr.HTML('''
+        <div class="logo-dashboard">
+            <!-- USIU Logo Placeholder - Replace the src with actual logo path -->
+            <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+        </div>
+        ''')
+
+        # Define containers for different views with initial animation state
+        dashboard_container = gr.Column(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInUp")
+        general_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        login_container = gr.Column(visible=False, elem_classes="container floating-card login-form-container pre-animation")
+        study_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        
+        # ------------- Dashboard View -------------
+        with dashboard_container:
+            gr.Markdown("<h1 class='with-logo'>AI Assistance Dashboard</h1>")
+            with gr.Column(elem_classes="dashboard-menu"):
+                gen_button = gr.Button("General Enquiries", elem_classes="menu-button")
+                study_button = gr.Button("Study with AI", elem_classes="menu-button")
+        
+        # ------------- General Academic Chat View -------------
+        with general_container:
+            back_gen = gr.Button("Back to Dashboard")
+            general_chat_component.render()
+        
+        # ------------- Login Form (for Study Support) View -------------
+        with login_container:
+            login_form_component.render()
+        
+        # ------------- Study Support Chat View -------------
+        with study_container:
+            back_study = gr.Button("Back to Dashboard")
+            study_support_component.render()
+        
+        # ------------- Navigation Callbacks -------------
+        # When "General Academic Chat" is selected from the dashboard.
+        gen_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # When "Study Support Chat" is selected from the dashboard, show the login view with animation.
+        study_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=True, elem_classes="container floating-card login-form-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # "Back to Dashboard" buttons with animation.
+        back_gen.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        back_study.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        login_back_btn.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # ------------- Authentication Logic -------------
+        login_btn.click(
+            handle_login,
+            inputs=[user_id_input, password_input],
+            outputs=[login_msg, user_id_error, password_error, proceed_btn, login_btn]
+        )
+        
+        # When "Proceed" is clicked (after successful authentication), show the study support chat with animation.
+        proceed_btn.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight")
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+    return dashboard.queue()
+
+import speech_recognition as sr
+from gtts import gTTS
+import os
+import tempfile
+import time
+import threading
+import queue
+from playsound import playsound
+# from voice_interface import VoiceInterface
+
+class VoiceInterface:
+    def __init__(self):
+        # Initialize speech recognizer
+        self.recognizer = sr.Recognizer()
+        self.audio_queue = queue.Queue()
+        self.recording = False
+        self.temp_dir = tempfile.mkdtemp()
+        
+    def start_recording(self):
+        """Start recording audio from the microphone"""
+        self.recording = True
+        threading.Thread(target=self._record_audio, daemon=True).start()
+        print("Recording started... Speak now!")
+    
+    def stop_recording(self):
+        """Stop recording audio"""
+        self.recording = False
+        print("Recording stopped.")
+    
+    def _record_audio(self):
+        """Record audio from microphone"""
+        try:
+            with sr.Microphone() as source:
+                # Adjust for ambient noise
+                self.recognizer.adjust_for_ambient_noise(source, duration=0.5)
+                
+                while self.recording:
+                    try:
+                        print("Listening...")
+                        audio = self.recognizer.listen(source, timeout=5, phrase_time_limit=10)
+                        
+                        # Process the audio in a separate thread
+                        threading.Thread(
+                            target=self._process_audio,
+                            args=(audio,),
+                            daemon=True
+                        ).start()
+                    except sr.WaitTimeoutError:
+                        continue
+                    except Exception as e:
+                        print(f"Error while listening: {e}")
+                        time.sleep(1)
+                        
+        except Exception as e:
+            print(f"Error in recording thread: {e}")
+    
+    def _process_audio(self, audio):
+        """Process recorded audio and convert to text"""
+        try:
+            # Use multiple APIs for better reliability
+            text = None
+            apis = [
+                lambda: self.recognizer.recognize_google(audio),
+                lambda: self.recognizer.recognize_whisper(audio),
+                lambda: self.recognizer.recognize_sphinx(audio)
+            ]
+            
+            for api_func in apis:
+                try:
+                    text = api_func()
+                    break
+                except:
+                    continue
+            
+            if text and text.strip():
+                print(f"Recognized: {text}")
+                self.audio_queue.put(text)
+            else:
+                print("Speech not recognized")
+                
+        except Exception as e:
+            print(f"Error processing speech: {e}")
+    
+    def get_text_from_speech(self, timeout=None):
+        """Get recognized text from the audio queue"""
+        try:
+            return self.audio_queue.get(timeout=timeout)
+        except queue.Empty:
+            return None
+    
+    def text_to_speech(self, text):
+        """Convert text to speech and play it"""
+        try:
+            # Create temporary file for audio
+            temp_file = os.path.join(self.temp_dir, f"speech_{int(time.time())}.mp3")
+            
+            # Generate speech
+            tts = gTTS(text=text, lang='en', slow=False)
+            tts.save(temp_file)
+            
+            # Play the audio
+            playsound(temp_file)
+            
+            # Clean up file after playing
+            if os.path.exists(temp_file):
+                os.remove(temp_file)
+                
+        except Exception as e:
+            print(f"Error in text-to-speech: {e}")
+            
+    def cleanup(self):
+        """Clean up temporary files"""
+        try:
+            for file in os.listdir(self.temp_dir):
+                os.remove(os.path.join(self.temp_dir, file))
+            os.rmdir(self.temp_dir)
+        except:
+            pass
+
+#############################
+# READ FILE UTILITY
+#############################
+def read_file(file):
+    file_extension = os.path.splitext(file.name)[1].lower()
+    
+    if file_extension == '.txt':
+        content = file.read().decode('utf-8')
+    elif file_extension == '.pdf':
+        pdf_reader = PyPDF2.PdfReader(file)
+        content = ''
+        for page in pdf_reader.pages:
+            text = page.extract_text()
+            if text:
+                content += text
+    elif file_extension in ['.docx', '.doc']:
+        doc = docx.Document(file)
+        content = "\n".join([para.text for para in doc.paragraphs])
+    elif file_extension in ['.xlsx', '.xls']:
+        df = pd.read_excel(file)
+        content = df.to_string()
+    elif file_extension in ['.pptx', '.ppt']:
+        prs = pptx.Presentation(file)
+        content = ''
+        for slide in prs.slides:
+            for shape in slide.shapes:
+                if hasattr(shape, 'text'):
+                    content += shape.text + '\n'
+    elif file_extension in ['.png', '.jpg', '.jpeg', '.gif']:
+        image = Image.open(file)
+        buffered = io.BytesIO()
+        image.save(buffered, format="PNG")
+        # Create an image variation via OpenAI's API (example)
+        response = openai.Image.create_variation(
+            image=buffered,
+            n=1,
+            size="256x256"
+        )
+        image_description = response['data'][0]['url']
+        content = f"[Image uploaded. Description: {image_description}]"
+    else:
+        content = f"Unsupported file type: {file_extension}"
+    
+    return content
+
+#############################
+# GLOBAL RETRIEVER SETUP (for RAG in general_chat_ui)
+#############################
+from vector_services.data_curator import DataCurator
+curator = DataCurator(knowledge_base_dir="usiu-knowledge-base")
+curator.load_vectorstore()
+# GLOBAL_RETRIEVER enables RAG for general chat.
+GLOBAL_RETRIEVER = curator.get_retriever()
+
+#############################
+# GENERAL CHAT UI (with RAG)
+#############################
+def general_chat_ui(system_prompt: str, model: str) -> None:
+    """
+    Creates a Gradio ChatInterface for general academic chat.
+    Uses additional_inputs for file upload, maintains RAG by retrieving context via GLOBAL_RETRIEVER,
+    and streams the response. The function takes three inputs (text message, state, file) and
+    yields incremental final responses as a string.
+    """
+
+    # def voice_button_click():
+    #     """Callback for the voice input button"""
+    #     voice_interface.start_recording()
+    #     # Wait for up to 10 seconds for voice input
+    #     text = voice_interface.get_text_from_speech(timeout=10)
+    #     voice_interface.stop_recording()
+    #     return text if text else ""
+
+    def general_chat(message: str, chat_history, file) -> str:
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                ),
+                "files": []
+            }
+            chat_history.insert(0, conv_header)  # Insert at the beginning
+        
+        # Start with the initial system prompt.
+        messages = [
+            {"role": "system", "content": system_prompt, "files": []},
+        ]
+        
+        # Add chat history to messages (all messages, including header).
+        if chat_history:
+            # If the first element is a tuple/list with two elements, assume pair format.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human, "files": []})
+                    messages.append({"role": "assistant", "content": assistant, "files": []})
+            # Otherwise, if they are dicts, include all messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    # Skip header messages when sending to API.
+                    if msg.get("role") == "header":
+                        continue
+                    # Ensure each message has a files field.
+                    msg_to_send = dict(msg)
+                    if "files" not in msg_to_send or msg_to_send["files"] is None:
+                        msg_to_send["files"] = []
+                    messages.append(msg_to_send)
+        
+        # If a file is uploaded, add its content to the messages.
+        if file is not None:
+            try:
+                file_content = read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}"
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}",
+                    "files": []
+                })
+        
+        # RAG: Retrieve additional context using GLOBAL_RETRIEVER if available.
+        if GLOBAL_RETRIEVER is not None:
+            try:
+                docs = GLOBAL_RETRIEVER.get_relevant_documents(message)
+                if docs:
+                    context_text = "\n\n".join([doc.page_content for doc in docs])
+                    # Insert the retrieved context as an additional system message.
+                    messages.insert(1, {
+                        "role": "system",
+                        "content": f"Additional Context:\n{context_text}",
+                        "files": []
+                    })
+            except Exception as e:
+                print("RAG retrieval failed:", e)
+        
+        chat_history.append({"role": "user", "content": message, "files": []})
+        messages.append({"role": "user", "content": message, "files": []})
+        
+        print("General Enquiries - Conversation with context:")
+        print(messages)
+        
+        # Call OpenAI's ChatCompletion with streaming enabled.
+        completion = openai.ChatCompletion.create(
+            model=model,
+            messages=messages,
+            max_tokens=2_000,
+            temperature=0.7,
+            stream=True,
+        )
+        
+        response = ""
+        for chunk in completion:
+            token = chunk.choices[0].delta.get("content", "")
+            response += token
+            yield response
+
+        # # After the response is completely generated, append a timestamp.
+        # timestamp = time.strftime("%I:%M %p", time.localtime())
+        # final_response = response + f"\n<span style='font-size:11px; color:#999;'>{timestamp}</span>"
+
+        # # If voice playback is enabled, read the response aloud in a separate thread
+        # if play_response:
+        #     threading.Thread(
+        #         target=voice_interface.text_to_speech,
+        #         args=(response,),
+        #         daemon=True
+        #     ).start()
+        
+        # yield final_response
+    
+    # iface = gr.ChatInterface(
+    #     fn=general_chat,
+    #     additional_inputs=[gr.File(label="Upload a file (optional)")],
+    #     additional_inputs_accordion="File Upload",
+    #     editable=True,
+    #     save_history=True,
+    #     title="General Academic Chat with File Upload",
+    #     type="messages",
+    #     cache_mode="eager"
+    # )
+    iface = gr.ChatInterface(
+        fn=general_chat,
+        additional_inputs=[gr.File(label="Upload a file (optional)", elem_classes="file-upload")],
+        additional_inputs_accordion=gr.Accordion("File Upload", open=False, elem_classes="additional-inputs-accordion"),
+        editable=True,
+        save_history=True,
+        title="General Enquiries",
+        description="<div style='display:flex; justify-content:center;'>Hi there! I'm your AI assistant, here to help you with queries related to USIU. Feel free to ask any questions or seek assistance.</div>",
+        type="messages",
+        cache_mode="eager"
+    )
+    return iface.queue()
+
+#############################
+# STUDY SUPPORT UI (without RAG)
+#############################
+def study_support_ui(system_prompt: str, model: str) -> None:
+    """
+    Creates a Gradio ChatInterface for study support.
+    Uses additional_inputs for file upload and streams the response using Claude's API.
+    No RAG is applied in this interface.
+    The function takes three inputs (text message, state, file) and returns a final response as a string.
+    """
+
+    # def voice_button_click():
+    #     """Callback for the voice input button"""
+    #     voice_interface.start_recording()
+    #     # Wait for up to 10 seconds for voice input
+    #     text = voice_interface.get_text_from_speech(timeout=10)
+    #     voice_interface.stop_recording()
+    #     return text if text else ""
+
+    def study_support_chat(message: str, chat_history, file) -> str:
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                )
+            }
+            chat_history.insert(0, conv_header)
+
+        # Build the messages list that will be sent to the API.
+        messages = []
+        if chat_history:
+            # If chat_history items are tuples/lists with two elements, unpack them.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human})
+                    messages.append({"role": "assistant", "content": assistant})
+            # Otherwise, if they are dicts, include only "role" and "content" for non-system messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    if msg.get("role") == "header":
+                        continue  # Skip header messages.
+                    msg_to_send = {"role": msg.get("role"), "content": msg.get("content")}
+                    messages.append(msg_to_send)
+        
+        # Add the current message.
+        messages.append({"role": "user", "content": message})
+        
+        # If a file is uploaded, add its content.
+        if file is not None:
+            try:
+                file_content = read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}"
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}"
+                })
+        
+        # Implement a retry mechanism to handle overloaded errors.
+        max_retries = 7
+        delay = 3  # seconds
+        attempt = 0
+        while attempt < max_retries:
+            try:
+                result = claude.messages.stream(
+                    model=model,
+                    max_tokens=64_000,
+                    system=system_prompt,
+                    messages=messages,
+                    extra_query={"extended_thinking": True}
+                )
+                response = ""
+                with result as stream:
+                    for text in stream.text_stream:
+                        response += text
+                        yield response  # Yield incremental responses.
+
+                # After generating the complete response
+                # if play_response:
+                #     threading.Thread(
+                #         target=voice_interface.text_to_speech,
+                #         args=(response,),
+                #         daemon=True
+                #     ).start()
+                
+                # yield final_response
+
+                break  # Exit the retry loop if successful.
+            except Exception as e:
+                # Check if error indicates the API is overloaded.
+                if "overloaded" in str(e).lower():
+                    attempt += 1
+                    yield f"Service unavailable. Retrying in {delay} seconds... (attempt {attempt}/{max_retries})\n"
+                    time.sleep(delay)
+                else:
+                    print(f"An error occurred: {str(e)}")
+                    break
+        else:
+            yield "The service is currently unavailable. Please try again later."
+    
+    # iface = gr.ChatInterface(
+    #     fn=study_support_chat,
+    #     additional_inputs=[gr.File(label="Upload a file (optional)")],
+    #     additional_inputs_accordion="File Upload",
+    #     editable=True,
+    #     save_history=True,
+    #     title="Study Support Chat with File Upload",
+    #     type="messages",
+    #     cache_mode="eager"
+    # )
+    iface = gr.ChatInterface(
+        fn=study_support_chat,
+        additional_inputs=[gr.File(label="Upload a file (optional)", elem_classes="file-upload")],
+        additional_inputs_accordion=gr.Accordion("File Upload", open=False, elem_classes="additional-inputs-accordion"),
+        editable=True,
+        save_history=True,
+        title="Study Bud",
+        description="<div style='display:flex; justify-content:center;'>Hi there! I'm your AI study bud. Feel free to ask questions, share resources, and get personalized support.</div>",
+        type="messages",
+        cache_mode="eager"
+    )
+    return iface.queue()

services/ui_service.py

@@ -0,0 +1,1560 @@
+# services/ui_service.py
+
+import re
+import os
+import time
+import openai
+import gradio as gr
+import threading
+from typing import List, Dict, Any, Tuple, Optional, Generator
+
+from configs.config import claude, GPT4O_MODEL, CLAUDE_MODEL
+from services.auth_service import (
+    authenticate, create_session, get_session, update_session_activity, 
+    end_session, check_inactivity, INACTIVITY_TIMEOUT
+)
+from services.file_service import FileProcessor
+from api_gateway.gateway import route_request
+# from vector_services.data_curator import DataCurator
+
+# Will be set when dashboard_ui is called (during runtime)
+GLOBAL_RETRIEVER = None
+
+
+# ----------------- New Summarization Helper -----------------
+def summarize_context(text: str, summarization_model: str = GPT4O_MODEL) -> str:
+    """
+    Summarize the given text concisely while preserving key details.
+    Uses the provided summarization model (e.g., GPT-4o or llama-3-8b).
+    """
+    summarization_prompt = (
+        "Summarize the following text concisely while preserving the essential details:\n\n"
+        f"{text}\n\nSummary:"
+    )
+    try:
+        # Non-streaming call to get the summary
+        response = openai.ChatCompletion.create(
+            model=summarization_model,
+            messages=[{"role": "system", "content": summarization_prompt}],
+            max_tokens=150,
+            temperature=0.5,
+        )
+        summary = response.choices[0].message.content.strip()
+        return summary
+    except Exception as e:
+        print("Summarization failed:", e)
+        # Fallback: return a truncated version if summarization fails
+        return text[:1000]
+
+def custom_css():
+    css = """
+    /* Professional custom CSS with transitions, hover effects, and responsive design */
+    body { 
+        font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif; 
+        background-color: #f8f9fa; 
+        margin: 0; 
+        padding: 0;
+        width: 100%;
+        overflow-x: hidden; /* Prevent horizontal scrolling */
+    }
+    h1, h2, h3 { 
+        text-align: center; 
+        color: #495057;
+    }
+    .gr-button:not(.secondary-button):not([aria-label="Clear"]):not([aria-label="Retry"]):not([aria-label="Undo"]):not(.chat-buttons button) { 
+        transition: background-color 0.3s ease, transform 0.3s ease; 
+        border-radius: 4px;
+        /* USIU-Africa theme color for buttons */
+        background-color: #000080;
+        color: white;
+    }
+    .gr-button:not(.secondary-button):not([aria-label="Clear"]):not([aria-label="Retry"]):not([aria-label="Undo"]):not(.chat-buttons button):hover { 
+        background-color: #000066; 
+        color: #fff; 
+        transform: scale(1.03);
+    }
+    .container { 
+        transition: opacity 0.5s ease-in-out;
+        padding: 4px;
+    }
+
+    /* Style the "New chat" button to match USIU-Africa theme */
+    button.secondary-button {
+        background-color: #000080 !important; /* USIU-Africa navy blue */
+        color: white !important;
+    }
+
+    button.secondary-button:hover {
+        background-color: #000066 !important; /* Slightly darker on hover */
+    }
+
+    /* Glassmorphism effect for floating cards */
+    .floating-card {
+        background: rgba(255, 255, 255, 0.85);
+        border-radius: 12px;
+        box-shadow: 
+            0 10px 25px rgba(0,0,0,0.08),
+            0 6px 10px rgba(0,0,0,0.12),
+            0 3px 3px rgba(0,0,0,0.15);
+        transition: all 0.3s cubic-bezier(0.25, 0.8, 0.25, 1);
+        padding: 25px;
+        margin: 15px auto; /* Reduced margin */
+        backdrop-filter: blur(10px);
+        border: 1px solid rgba(255,255,255,0.25);
+        width: 95%; /* Increased width */
+        max-width: 98%; /* Increased max-width */
+    }
+
+    .floating-card:hover {
+        box-shadow: 
+            0 15px 30px rgba(0,0,0,0.15),
+            0 10px 10px rgba(0,0,0,0.18);
+        transform: translateY(-5px);
+        background: rgba(255, 255, 255, 0.9);
+    }
+
+    /* Login form styling with responsiveness */
+    .login-form-container {
+        width: 98% !important; /* Increased width for mobile */
+        max-width: 500px !important;
+        margin: 30px auto !important; /* Reduced top/bottom margin */
+        background: rgba(255, 255, 255, 0.88) !important;
+        backdrop-filter: blur(12px) !important;
+        border: 1px solid rgba(255, 255, 255, 0.3) !important;
+        border-top: 3px solid #000080 !important;
+        padding: 20px 15px !important; /* Added horizontal padding */
+    }
+
+    /* Dashboard container styling with responsiveness */
+    .dashboard-card {
+        width: 98% !important; /* Take almost full width on mobile */
+        max-width: 700px !important;
+        margin: 20px auto !important; /* Reduced margin */
+        background: rgba(255, 255, 255, 0.88) !important;
+        backdrop-filter: blur(12px) !important;
+        height: auto !important;
+        min-height: 500px !important;
+        border: 1px solid rgba(255, 255, 255, 0.3) !important;
+        border-top: 3px solid #000080 !important;
+        opacity: 0;
+        animation: dashboardFadeIn 1.5s forwards ease-in-out;
+        padding: 20px 10px !important; /* Reduced horizontal padding */
+    }
+
+    /* A subtle gradient background to the cards */
+    .dashboard-card, .login-form-container {
+        background: linear-gradient(
+            135deg, 
+            rgba(255, 255, 255, 0.9) 0%, 
+            rgba(255, 255, 255, 0.8) 100%
+        ) !important;
+    }
+
+    /* Logo container styling with responsive adjustments */
+    .logo-container {
+        text-align: center;
+        margin-bottom: 25px;
+        position: relative;
+        width: 100%;
+    }
+
+    .logo {
+        max-height: 80px;
+        max-width: 90%; /* Increased max-width */
+        margin: 0 auto;
+        display: block;
+    }
+
+    .logo-dashboard {
+        position: absolute;
+        top: 15px;
+        left: 15px;
+        max-height: 60px;
+        max-width: 35%; /* Increased max-width */
+        z-index: 100;
+        opacity: 1; /* Changed from 0 to 1 to make it fully visible */
+    }
+
+    .with-logo {
+        margin-top: 10px;
+    }
+
+    /* Chat UI container with extended width and responsiveness */
+    .chat-container {
+        max-width: 1000px;
+        width: 98%; /* Increased width for mobile */
+        margin: 0 auto;
+        opacity: 0;
+        transform: translateY(20px);
+        animation: fadeInUp 0.7s forwards;
+    }
+
+    /* Increase chat window height with responsive adjustment */
+    .chatbot-container, .gradio-container .chat {
+        height: 80vh !important;
+        max-height: 900px !important;
+        width: 98% !important; /* Take up more width */
+        margin: 0 auto !important;
+    }
+    
+    /* Make Gradio container take full width on mobile */
+    .gradio-container {
+        width: 100% !important;
+        max-width: 100% !important;
+        margin: 0 !important;
+        padding: 0 !important;
+    }
+
+    /* Logout button styling */
+    .logout-btn {
+        /* When using a Gradio Button with elem_classes, these styles will be applied */
+        background-color: #f44336 !important;
+        color: white !important;
+        border: none !important;
+        padding: 8px 16px !important;
+        cursor: pointer !important;
+        border-radius: 4px !important;
+        display: flex !important;
+        align-items: center !important;
+        gap: 8px !important;
+        font-size: 14px !important;
+        transition: background-color 0.3s ease !important;
+    }
+    
+    .logout-btn:hover {
+        background-color: #d32f2f !important; 
+    }
+    
+    .logout-btn svg {
+        width: 16px;
+        height: 16px;
+        fill: white;
+    }
+    
+    .logout-btn-container {
+        position: relative;
+        width: 100%;
+        height: 0px;
+    }
+    
+    .session-info {
+        position: absolute;
+        top: 50px;
+        right: 15px;
+        font-size: 12px;
+        color: #666;
+        background-color: rgba(255, 255, 255, 0.7);
+        padding: 4px 8px;
+        border-radius: 4px;
+    }
+
+    /* Inactivity warning modal */
+    .inactive-warning {
+        position: fixed;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        background-color: white;
+        border: 1px solid #ccc;
+        border-radius: 8px;
+        padding: 20px;
+        z-index: 1001;
+        box-shadow: 0 4px 12px rgba(0,0,0,0.15);
+        max-width: 400px;
+        width: 90%;
+        text-align: center;
+        display: none;
+    }
+    
+    .inactive-warning h3 {
+        margin-top: 0;
+        color: #f44336;
+    }
+    
+    .inactive-warning button {
+        margin-top: 15px;
+        background-color: #000080;
+        color: white;
+        border: none;
+        padding: 8px 16px;
+        border-radius: 4px;
+        cursor: pointer;
+    }
+    
+    .inactive-warning button:hover {
+        background-color: #000066;
+    }
+    
+    .overlay {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        bottom: 0;
+        background-color: rgba(0,0,0,0.5);
+        z-index: 1000;
+        display: none;
+    }
+
+    /* Dashboard menu buttons styling with responsiveness */
+    .dashboard-menu {
+        display: flex;
+        flex-direction: column;
+        align-items: center;
+        justify-content: center;
+        min-height: 60vh;
+        gap: 8px;
+        opacity: 0;
+        animation: menuFadeIn 3s forwards ease-in-out;
+        animation-delay: 0.7s;
+        padding: 15px 0; /* Reduced padding */
+        width: 100%; /* Full width */
+    }
+
+    .menu-button {
+        width: 95% !important; /* Increased width for mobile */
+        max-width: 300px !important;
+        height: auto !important;
+        min-height: 60px !important;
+        font-size: 16px !important;
+        font-weight: 500 !important;
+        margin: 6px auto !important; /* Reduced margin */
+        border-radius: 8px !important;
+        box-shadow: 0 2px 5px rgba(0,0,0,0.1) !important;
+        transition: transform 0.3s ease, box-shadow 0.3s ease !important;
+        background-color: #000080 !important;
+        color: white !important;
+        opacity: 0;
+        animation: buttonsFadeIn 0.7s forwards ease-in-out;
+        animation-delay: calc(var(--button-index, 0) * 0.3s + 1s);
+        padding: 10px 15px !important;
+        display: flex !important;
+        align-items: center !important;
+        justify-content: center !important;
+        text-align: center !important;
+        word-wrap: break-word !important;
+    }
+
+    .menu-button:hover {
+        transform: scale(1.02);
+        background-image: linear-gradient(to bottom right, #000080, #0000cc);
+        transition: transform 0.5s ease;
+        box-shadow: 0 4px 8px rgba(0,0,0,0.2) !important;
+    }
+
+    /* 3D Loader CSS with responsive sizing */
+    .loader {
+        width: 40px; /* Reduced size */
+        height: 40px; /* Reduced size */
+        perspective: 100px;
+        position: fixed;
+        top: 50%;
+        left: 50%;
+        transform: translate(-50%, -50%);
+        z-index: 9999;
+        display: none;
+    }
+    .cube {
+        width: 100%;
+        height: 100%;
+        background: #000080;
+        transform: rotateX(0deg) rotateY(0deg);
+        animation: spinCube 1.5s infinite ease-in-out;
+    }
+    @keyframes spinCube {
+        0%   { transform: rotateX(0deg) rotateY(0deg); }
+        25%  { transform: rotateX(90deg) rotateY(0deg); }
+        50%  { transform: rotateX(90deg) rotateY(90deg); }
+        75%  { transform: rotateX(0deg) rotateY(90deg); }
+        100% { transform: rotateX(0deg) rotateY(0deg); }
+    }
+    
+    /* Dashboard specific fade-in animations */
+    @keyframes dashboardFadeIn {
+        0% {
+            opacity: 0;
+            transform: translateY(30px);
+        }
+        100% {
+            opacity: 1;
+            transform: translateY(0);
+        }
+    }
+    
+    @keyframes menuFadeIn {
+        0% {
+            opacity: 0;
+            transform: scale(0.95);
+        }
+        100% {
+            opacity: 1;
+            transform: scale(1);
+        }
+    }
+    
+    @keyframes buttonsFadeIn {
+        0% {
+            opacity: 0;
+            transform: translateX(-15px);
+        }
+        100% {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    /* Adding transition effects for interfaces */
+    @keyframes fadeInUp {
+        from {
+            opacity: 0;
+            transform: translateY(20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateY(0);
+        }
+    }
+
+    @keyframes fadeInRight {
+        from {
+            opacity: 0;
+            transform: translateX(20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    @keyframes fadeInLeft {
+        from {
+            opacity: 0;
+            transform: translateX(-20px);
+        }
+        to {
+            opacity: 1;
+            transform: translateX(0);
+        }
+    }
+
+    /* Container animation classes that can be dynamically applied */
+    .animate-fadeInUp {
+        animation: fadeInUp 0.7s forwards;
+    }
+
+    .animate-fadeInRight {
+        animation: fadeInRight 0.7s forwards;
+    }
+
+    .animate-fadeInLeft {
+        animation: fadeInLeft 0.7s forwards;
+    }
+
+    /* Initial state for containers to be animated */
+    .pre-animation {
+        opacity: 0;
+    }
+
+    /* Specifically target Gradio elements to make them more mobile-friendly */
+    .gradio-container {
+        margin-left: 0 !important;
+        margin-right: 0 !important;
+    }
+    
+    /* Adjust textbox and button widths for mobile */
+    .gr-textbox {
+        width: 100% !important;
+    }
+    
+    .gr-button-primary {
+        width: 100% !important;
+        margin: 5px 0 !important;
+    }
+    
+    /* Make all interface elements take more width on mobile */
+    .interface-elements {
+        width: 98% !important;
+        max-width: 100% !important;
+        margin: 0 auto !important;
+    }
+    
+    /* Fix padding for form elements */
+    input, select, textarea, button {
+        box-sizing: border-box !important;
+    }
+
+    /* Ensure minimum touch target size for all clickable elements 
+       BUT exclude accordion, file input, and chat action buttons */
+    button:not(.accordion-button):not(.file-upload button):not([aria-label="Clear"]):not([aria-label="Retry"]):not([aria-label="Undo"]):not(.chat-buttons button), 
+    .gr-button:not(.file-upload .gr-button):not(.chat-buttons .gr-button), 
+    a, 
+    input[type="submit"], 
+    input[type="button"] {
+        min-height: 44px !important; /* Apple's recommended minimum touch target size */
+        min-width: 44px !important;
+    }
+    
+    /* Remove any unnecessary margins from Gradio components */
+    .gradio-container .gr-form > *, .gradio-container .gr-group > * {
+        margin-bottom: 8px !important;
+    }
+    
+    /* Ensure Gradio container does not exceed viewport width */
+    #component-0, #component-1, #component-2, #component-3, #component-4, #component-5,
+    #component-6, #component-7, #component-8, #component-9, #component-10 {
+        max-width: 100vw !important;
+        overflow-x: hidden !important;
+    }
+
+    /* Media Queries for better responsiveness */
+    @media screen and (max-width: 768px) {
+        body {
+            padding: 0 !important; /* Remove body padding on mobile */
+        }
+        
+        .dashboard-card {
+            width: 100% !important; /* Full width */
+            padding: 15px 8px !important; /* Reduced padding */
+            margin: 10px auto !important; /* Reduced margin */
+            border-radius: 0 !important; /* Optional: Remove border radius for full-width look */
+        }
+        
+        .login-form-container {
+            width: 100% !important; /* Full width */
+            padding: 15px 10px !important; /* Reduced padding */
+            margin: 10px auto !important; /* Reduced margin */
+            border-radius: 0 !important; /* Optional: Remove border radius for full-width look */
+        }
+        
+        .menu-button {
+            width: 98% !important; /* Almost full width */
+            font-size: 14px !important;
+            min-height: 50px !important;
+        }
+        
+        .logo-dashboard {
+            max-height: 40px;
+            top: 10px;
+            left: 10px;
+        }
+        
+        h1 {
+            font-size: 1.5rem !important;
+            margin-top: 10px !important;
+            margin-bottom: 15px !important;
+        }
+        
+        h2 {
+            font-size: 1.3rem !important;
+            margin-top: 8px !important;
+            margin-bottom: 12px !important;
+        }
+        
+        h3 {
+            font-size: 1.1rem !important;
+            margin-top: 6px !important;
+            margin-bottom: 10px !important;
+        }
+        
+        /* Make chat interface take full width */
+        .chat-container, .chatbot-container {
+            width: 100% !important;
+            margin: 0 !important;
+            padding: 0 5px !important;
+        }
+        
+        /* Adjust Gradio containers */
+        .gradio-container {
+            padding: 0 !important;
+        }
+        
+        /* Adjust logout button for mobile */
+        .logout-btn {
+            top: 5px;
+            right: 5px;
+            padding: 6px 12px !important;
+            font-size: 12px !important;
+        }
+        
+        .session-info {
+            top: 40px;
+            right: 5px;
+            font-size: 10px;
+        }
+    }
+
+    @media screen and (max-width: 480px) {
+        .dashboard-card {
+            padding: 10px 5px !important; /* Further reduced padding */
+            margin: 0 auto !important; /* Remove margin completely */
+            border-radius: 0 !important; /* Remove border radius */
+            width: 100% !important; /* Full width */
+        }
+        
+        .login-form-container {
+            padding: 10px 5px !important; /* Further reduced padding */
+            margin: 0 auto !important; /* Remove margin completely */
+            border-radius: 0 !important; /* Remove border radius */
+            width: 100% !important; /* Full width */
+        }
+        
+        .menu-button {
+            font-size: 13px !important;
+            min-height: 45px !important;
+            margin: 5px auto !important;
+            width: 100% !important; /* Full width */
+            border-radius: 6px !important; /* Slightly reduced border radius */
+        }
+        
+        .logo-dashboard {
+            max-height: 35px;
+            top: 5px;
+            left: 5px;
+        }
+        
+        /* Adjust spacing in forms for mobile */
+        input, select, textarea {
+            margin-bottom: 8px !important;
+            padding: 8px !important;
+            width: 100% !important;
+        }
+        
+        /* Reduce padding and margins for all content */
+        .floating-card, .gr-box, .gr-panel {
+            padding: 10px 5px !important;
+            margin: 5px 0 !important;
+            width: 100% !important;
+        }
+        
+        /* Full width for all UI components */
+        .gr-form, .gr-input, .gr-button, .gr-box {
+            width: 100% !important;
+            margin-left: 0 !important;
+            margin-right: 0 !important;
+        }
+    }
+
+    /* Additional responsive handling for extreme screen sizes */
+    @media screen and (max-width: 320px) {
+        /* For very small screens like older iPhones */
+        .menu-button {
+            font-size: 11px !important;
+            min-height: 40px !important;
+            padding: 8px 5px !important;
+        }
+        
+        .dashboard-card {
+            padding: 5px 3px !important;
+        }
+        
+        h1 {
+            font-size: 1.3rem !important;
+        }
+        
+        h2 {
+            font-size: 1.1rem !important;
+        }
+        
+        h3 {
+            font-size: 1rem !important;
+        }
+    }
+
+    @media screen and (min-width: 1600px) {
+        /* For very large screens */
+        .dashboard-card {
+            max-width: 1000px !important;
+        }
+        
+        .menu-button {
+            max-width: 400px !important;
+        }
+    }
+
+    /* For landscape orientation on mobile */
+    @media screen and (max-height: 500px) and (orientation: landscape) {
+        .dashboard-menu {
+            min-height: auto;
+            padding: 5px 0;
+        }
+        
+        .dashboard-card {
+            min-height: 300px !important;
+        }
+        
+        .menu-button {
+            min-height: 40px !important;
+            margin: 4px auto !important;
+        }
+    }
+    
+    /* Fixed positions for mobile views */
+    .fixed-top {
+        position: fixed;
+        top: 0;
+        left: 0;
+        right: 0;
+        z-index: 1000;
+    }
+    
+    .fixed-bottom {
+        position: fixed;
+        bottom: 0;
+        left: 0;
+        right: 0;
+        z-index: 1000;
+    }
+    """
+    return css
+
+# ----------------- Notification Helpers -----------------
+
+def show_success(message: str, duration: float = 10, visible: bool = True, title: str = "Success") -> None:
+    """Display a success notification"""
+    styled_message = (
+        f'<span style="color: #2e7d32; background-color: #c8e6c9; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Success(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+def show_error(message: str, duration: float = 13, visible: bool = True, title: str = "Error") -> None:
+    """Display an error notification"""
+    styled_message = (
+        f'<span style="color: #c62828; background-color: #ffcdd2; padding: 10px; '
+        f'border-radius: 4px; display: block;">{message}</span>'
+    )
+    gr.Error(styled_message, duration=duration, visible=visible, title=title)
+    # Add a small delay to help the modal appear
+    time.sleep(0.1)
+
+# ----------------- Login Form UI -----------------
+
+def login_form_ui():
+    """Create and return the login form interface"""
+    with gr.Blocks() as login_form:
+        # USIU logo
+        gr.HTML('''
+        <div class="logo-container">
+            <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+        </div>
+        ''')
+
+        gr.Markdown("## Please Login")
+        user_id_input = gr.Textbox(
+            placeholder="Enter your User ID", 
+            label="User ID", 
+            type="email", 
+            autofocus=True
+        )
+        # Error message for invalid user ID
+        user_id_error = gr.Markdown("", visible=True)
+        
+        password_input = gr.Textbox(
+            placeholder="Enter your Password", 
+            label="Password", 
+            type="password"
+        )
+        # Error message for invalid password
+        password_error = gr.Markdown("", visible=True)
+        
+        login_btn = gr.Button("Login")
+        # Error message for invalid credentials
+        login_msg = gr.Markdown("")
+        proceed_btn = gr.Button("Proceed", visible=False)
+        back_btn = gr.Button("Back to Dashboard")
+        
+        # Hidden field to store session ID
+        session_id = gr.Textbox(visible=False)
+    # Return the login form along with the necessary components in order.
+    return login_form, user_id_input, user_id_error, password_input, password_error, login_btn, login_msg, proceed_btn, back_btn, session_id
+
+# ----------------- Authentication Logic -----------------
+
+def handle_login(user_id, password):
+    """
+    Validates login fields and the User ID (which must end with '@usiu.ac.ke').
+    Returns appropriate error messages and updates UI components.
+    """
+    try:
+        user_id = user_id.strip() if user_id else ""
+        password = password.strip() if password else ""
+
+        # Both fields empty:
+        if user_id == "" and password == "":
+            show_error("Please enter your User ID and Password.")
+            return (
+                "<span style='color:#c62828;'>Please enter your User ID and Password.</span>",
+                "",   # No field-specific error for User ID.
+                "",   # No field-specific error for Password.
+                gr.update(visible=False),
+                gr.update(visible=True),
+                ""    # No session ID since login failed
+            )
+        # User ID is empty:
+        elif user_id == "":
+            show_error("User ID is required.")
+            return (
+                "", 
+                "<span style='color:#c62828;'>User ID is required.</span>",
+                "",
+                gr.update(visible=False),
+                gr.update(visible=True),
+                ""    # No session ID since login failed
+            )
+        # Password is empty:
+        elif password == "":
+            show_error("Password is required.")
+            return (
+                "",
+                "",
+                "<span style='color:#c62828;'>Password is required.</span>",
+                gr.update(visible=False),
+                gr.update(visible=True),
+                ""    # No session ID since login failed
+            )
+        else:
+            # Validate the User ID: must end with "@usiu.ac.ke"
+            email_regex = r'^[\w\.-]+@usiu\.ac\.ke$'
+            if not re.match(email_regex, user_id):
+                show_error("User ID must be a valid \"@usiu.ac.ke\" email address.")
+                return (
+                    "",
+                    "<span style='color:#c62828;'>User ID must be a valid @usiu.ac.ke email address.</span>",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True),
+                    ""    # No session ID since login failed
+                )
+            # Attempt authentication.
+            if authenticate(user_id, password):
+                # Create a session for the authenticated user
+                session_id = create_session(user_id)
+                
+                show_success("Login successful! Click 'Proceed' to continue!", duration=10)
+                return (
+                    "", 
+                    "",
+                    "",
+                    gr.update(visible=True), # Show Proceed button.
+                    gr.update(visible=False), # Hide Login button.
+                    session_id   # Return the session ID for the new session
+                )
+            else:
+                show_error("Invalid credentials. Please try again.")
+                return (
+                    "<span style='color:#c62828;'>Invalid credentials. Please try again.</span>",
+                    "",
+                    "",
+                    gr.update(visible=False),
+                    gr.update(visible=True),
+                    ""    # No session ID since login failed
+                )
+    except Exception as e:
+        show_error(f"System error: {str(e)}. Please ensure required modules are imported.")
+        return (
+            "<span style='color:#c62828;'>System error encountered.</span>",
+            "",
+            "",
+            gr.update(visible=False),
+            gr.update(visible=True),
+            ""    # No session ID since login failed
+        )
+
+def handle_logout(session_id):
+    """End the user session and redirect to dashboard"""
+    end_session(session_id)
+    return [
+        gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+        gr.update(visible=False, elem_classes="chat-container pre-animation"),
+        gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+        gr.update(visible=False, elem_classes="chat-container pre-animation")
+    ]
+
+# ----------------- Chat Interfaces -----------------
+
+def general_chat_ui(system_prompt: str, model: str) -> gr.ChatInterface:
+    """Creates a Gradio ChatInterface for general academic chat with RAG."""
+
+    def general_chat(message: str, chat_history, file) -> str:
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                ),
+                "files": []
+            }
+            chat_history.insert(0, conv_header)  # Insert at the beginning
+        
+        # Start with the initial system prompt.
+        messages = [
+            {"role": "system", "content": system_prompt, "files": []},
+        ]
+        
+        # Add chat history to messages (all messages, including header).
+        if chat_history:
+            # If the first element is a tuple/list with two elements, assume pair format.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human, "files": []})
+                    messages.append({"role": "assistant", "content": assistant, "files": []})
+            # Otherwise, if they are dicts, include all messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    # Skip header messages when sending to API.
+                    if msg.get("role") == "header":
+                        continue
+                    # Ensure each message has a files field.
+                    msg_to_send = dict(msg)
+                    if "files" not in msg_to_send or msg_to_send["files"] is None:
+                        msg_to_send["files"] = []
+                    messages.append(msg_to_send)
+        
+        # If a file is uploaded, add its content to the messages.
+        if file is not None:
+            try:
+                file_content = FileProcessor.read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}"
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}",
+                    "files": []
+                })
+        
+        # RAG: Retrieve additional context using GLOBAL_RETRIEVER if available.
+        # if GLOBAL_RETRIEVER is not None:
+        #     try:
+        #         docs = GLOBAL_RETRIEVER.get_relevant_documents(message)
+        #         if docs:
+        #             context_text = "\n\n".join([doc.page_content for doc in docs])
+        #             # Insert the retrieved context as an additional system message.
+        #             messages.insert(1, {
+        #                 "role": "system",
+        #                 "content": f"Additional Context:\n{context_text}",
+        #                 "files": []
+        #             })
+        #     except Exception as e:
+        #         print("RAG retrieval failed:", e)
+
+        # First, ensure no None values are present in the messages list.
+        messages = [msg for msg in messages if msg is not None]
+
+        # RAG Retrieval and Summarization Implementation:
+        if GLOBAL_RETRIEVER is not None:
+            try:
+                # Retrieve relevant documents using the global retriever.
+                docs = GLOBAL_RETRIEVER.get_relevant_documents(message)
+                if docs:
+                    summarized_texts = []
+                    for doc in docs:
+                        # Summarize each document's page content.
+                        # Use the summarize_context() function; if it returns None, fallback to an empty string.
+                        summary = summarize_context(doc.page_content, GPT4O_MODEL) or ""
+                        # Only add non-empty summaries.
+                        if summary.strip():
+                            summarized_texts.append(summary)
+                    # If we have one or more summaries, combine them and insert as an additional context.
+                    if summarized_texts:
+                        context_text = "\n\n".join(summarized_texts)
+                        messages.insert(1, {
+                            "role": "system",
+                            "content": f"Additional Context Summaries:\n{context_text}",
+                            "files": []  # Always provide an empty list for the "files" key.
+                        })
+            except Exception as e:
+                print("RAG retrieval failed:", e)
+
+        
+        chat_history.append({"role": "user", "content": message, "files": []})
+        messages.append({"role": "user", "content": message, "files": []})
+        
+        # Call OpenAI's ChatCompletion with streaming enabled.
+        completion = openai.ChatCompletion.create(
+            model=model,
+            messages=messages,
+            max_tokens=1_000,
+            temperature=0.7,
+            stream=True,
+        )
+        
+        response = ""
+        for chunk in completion:
+            token = chunk.choices[0].delta.get("content", "")
+            response += token
+            yield response
+    
+    iface = gr.ChatInterface(
+        fn=general_chat,
+        additional_inputs=[gr.File(label="Upload a file (optional)", elem_classes="file-upload")],
+        additional_inputs_accordion=gr.Accordion("File Upload", open=False, elem_classes="additional-inputs-accordion"),
+        editable=True,
+        save_history=True,
+        title="General Enquiries",
+        description="<div style='display:flex; justify-content:center;'>Hi there! I'm your AI assistant, here to help you with queries related to USIU. Feel free to ask any questions or seek assistance.</div>",
+        type="messages",
+        cache_mode="eager"
+    )
+    return iface.queue()
+
+def study_support_ui(system_prompt: str, model: str) -> gr.ChatInterface:
+    """Creates a Gradio ChatInterface for study support with Claude."""
+
+    def study_support_chat(message: str, chat_history, file, session_id) -> str:
+        # Update session activity timestamp
+        if session_id:
+            update_session_activity(session_id)
+            
+            # Check if session is still valid
+            session = get_session(session_id)
+            if not session or not session.get("logged_in", False):
+                return "Your session has expired. Please log in again."
+        
+        # Ensure chat_history is a list.
+        if chat_history is None:
+            chat_history = []
+
+        # If a file is uploaded and the message is empty, replace the empty message with the file name.
+        if not message.strip() and file is not None:
+            message = f"Uploaded file: {os.path.basename(file.name)}"
+
+        # If this is a new conversation, insert a conversation header.
+        if not chat_history:
+            date_str = time.strftime("%Y-%m-%d %H:%M", time.localtime())
+            conv_header = {
+                "role": "header",
+                "content": (
+                    f"<div style='text-align: center; font-weight: bold; font-size: 16px; color: #000;'>"
+                    f"Conversation started on {date_str}"
+                    f"</div>"
+                )
+            }
+            chat_history.insert(0, conv_header)
+
+        # Build the messages list that will be sent to the API.
+        messages = []
+        if chat_history:
+            # If chat_history items are tuples/lists with two elements, unpack them.
+            if isinstance(chat_history[0], (tuple, list)) and len(chat_history[0]) == 2:
+                for human, assistant in chat_history:
+                    messages.append({"role": "user", "content": human})
+                    messages.append({"role": "assistant", "content": assistant})
+            # Otherwise, if they are dicts, include only "role" and "content" for non-system messages.
+            elif isinstance(chat_history[0], dict):
+                for msg in chat_history:
+                    if msg is None:
+                        continue
+                    if msg.get("role") == "header":
+                        continue  # Skip header messages.
+                    msg_to_send = {"role": msg.get("role"), "content": msg.get("content")}
+                    messages.append(msg_to_send)
+        
+        # Add the current message.
+        messages.append({"role": "user", "content": message})
+        
+        # If a file is uploaded, add its content.
+        if file is not None:
+            try:
+                file_content = FileProcessor.read_file(file)
+                messages.append({
+                    "role": "user",
+                    "content": f"Here's the content of the uploaded file:\n\n{file_content}"
+                })
+            except Exception as e:
+                messages.append({
+                    "role": "user",
+                    "content": f"Error reading file: {str(e)}"
+                })
+        
+        # Implement a retry mechanism to handle overloaded errors.
+        max_retries = 7
+        delay = 3  # seconds
+        attempt = 0
+        while attempt < max_retries:
+            try:
+                # Use Claude's API for the study support interface
+                result = claude.messages.stream(
+                    model=model,
+                    max_tokens=63_500,
+                    system=system_prompt,
+                    messages=messages,
+                    extra_query={"extended_thinking": True}
+                )
+                response = ""
+                with result as stream:
+                    for text in stream.text_stream:
+                        response += text
+                        yield response  # Yield incremental responses.
+
+                break  # Exit the retry loop if successful.
+            except Exception as e:
+                # Check if error indicates the API is overloaded.
+                if "overloaded" in str(e).lower():
+                    attempt += 1
+                    yield f"Service unavailable. Retrying in {delay} seconds... (attempt {attempt}/{max_retries})\n"
+                    time.sleep(delay)
+                else:
+                    print(f"An error occurred: {str(e)}")
+                    break
+        else:
+            yield "The service is currently unavailable. Please try again later."
+    
+    iface = gr.ChatInterface(
+        fn=study_support_chat,
+        additional_inputs=[
+            gr.File(label="Upload a file (optional)", elem_classes="file-upload"),
+            gr.Textbox(visible=False)  # Hidden input for session_id
+        ],
+        additional_inputs_accordion=gr.Accordion("File Upload", open=False, elem_classes="additional-inputs-accordion"),
+        editable=True,
+        save_history=True,
+        title="Study Bud",
+        description="<div style='display:flex; justify-content:center;'>Hi there! I'm your AI study bud. Feel free to ask questions, share resources, and get personalized support.</div>",
+        type="messages",
+        cache_mode="eager"
+    )
+    return iface.queue()
+
+# ---------- Dashboard UI ----------
+
+def dashboard_ui(general_chat_prompt: str, general_model: str, 
+                 study_prompt: str, study_model: str, retriever=None):
+    """
+    Creates a dashboard with professional styling, two main menus (General Chat and Study Support),
+    and smooth transitions between views. For Study Support, a login form (with authentication)
+    is shown before revealing the chat interface.
+    
+    Args:
+        general_chat_prompt: System prompt for general enquiries
+        general_model: Model ID for general chat (e.g., GPT4O_MODEL)
+        study_prompt: System prompt for study support
+        study_model: Model ID for study support (e.g., CLAUDE_MODEL)
+        retriever: The retriever to use for RAG in general chat
+    """
+    global GLOBAL_RETRIEVER
+    GLOBAL_RETRIEVER = retriever
+    
+    # Retrieve the existing chat interfaces.
+    general_chat_component = general_chat_ui(general_chat_prompt, general_model)
+    study_support_component = study_support_ui(study_prompt, study_model)
+    # Retrieve the login form.
+    (login_form_component, user_id_input, user_id_error, password_input, password_error,
+     login_btn, login_msg, proceed_btn, login_back_btn, session_id) = login_form_ui()
+    
+    with gr.Blocks(css=custom_css()) as dashboard:
+        # Inject JavaScript for animations, loading effects, and inactivity timer
+        gr.HTML('''
+        <script>
+        document.addEventListener("DOMContentLoaded", function() {
+            // Create and style the spinner element
+            let spinner = document.createElement("div");
+            spinner.className = "loader";
+            spinner.innerHTML = '<div class="cube"></div>';
+            document.body.appendChild(spinner);
+            
+            // Create inactivity warning modal
+            let warningModal = document.createElement("div");
+            warningModal.className = "inactive-warning";
+            warningModal.innerHTML = `
+                <h3>Session Timeout Warning</h3>
+                <p>Your session will expire due to inactivity in <span id="countdown">60</span> seconds.</p>
+                <p>Click the button below to continue your session.</p>
+                <button id="stay-active">Stay Active</button>
+            `;
+            document.body.appendChild(warningModal);
+            
+            // Create overlay for modal
+            let overlay = document.createElement("div");
+            overlay.className = "overlay";
+            document.body.appendChild(overlay);
+            
+            // Variables for inactivity tracking
+            let inactivityTimer;
+            let lastActivity = Date.now();
+            let countdownTimer;
+            let countdownTime = 60; // Countdown from 60 seconds
+            
+            // Function to reset inactivity timer
+            function resetInactivityTimer() {
+                lastActivity = Date.now();
+                
+                // Clear existing timer
+                if (inactivityTimer) {
+                    clearTimeout(inactivityTimer);
+                }
+                
+                // Set new timer - show warning after 14 minutes of inactivity
+                inactivityTimer = setTimeout(function() {
+                    showInactivityWarning();
+                }, 14 * 60 * 1000); // 14 minutes in milliseconds
+            }
+            
+            // Function to show inactivity warning
+            function showInactivityWarning() {
+                overlay.style.display = "block";
+                warningModal.style.display = "block";
+                
+                // Start countdown
+                countdownTime = 60;
+                document.getElementById("countdown").textContent = countdownTime;
+                
+                countdownTimer = setInterval(function() {
+                    countdownTime--;
+                    document.getElementById("countdown").textContent = countdownTime;
+                    
+                    if (countdownTime <= 0) {
+                        clearInterval(countdownTimer);
+                        // Find and click logout button to end session
+                        const logoutButton = document.querySelector('.logout-btn');
+                        if (logoutButton) {
+                            logoutButton.click();
+                        }
+                        hideInactivityWarning();
+                    }
+                }, 1000);
+            }
+            
+            // Function to hide inactivity warning
+            function hideInactivityWarning() {
+                overlay.style.display = "none";
+                warningModal.style.display = "none";
+                if (countdownTimer) {
+                    clearInterval(countdownTimer);
+                }
+            }
+            
+            // Event listener for "Stay Active" button
+            document.getElementById("stay-active").addEventListener("click", function() {
+                hideInactivityWarning();
+                resetInactivityTimer();
+            });
+            
+            // Track user activity
+            ["mousemove", "keydown", "click", "scroll", "touchstart"].forEach(function(event) {
+                document.addEventListener(event, function() {
+                    // Only reset timer if we're not showing the warning
+                    if (warningModal.style.display !== "block") {
+                        resetInactivityTimer();
+                    }
+                });
+            });
+            
+            // Initial setup of inactivity timer
+            resetInactivityTimer();
+                
+            // Show the spinner when needed
+            spinner.style.display = "none";  // Initially hidden
+            
+            // Function to show spinner
+            function showSpinner() {
+                spinner.style.display = "block";
+            }
+            
+            // Function to hide spinner
+            function hideSpinner() {
+                spinner.style.display = "none";
+            }
+            
+            // Function to handle animation transitions
+            function setupAnimations() {
+                // Get all containers that might be animated
+                const containers = document.querySelectorAll('.container, .chat-container');
+                
+                // Add transition end listener to each container
+                containers.forEach(container => {
+                    container.addEventListener('animationend', function(e) {
+                        // When animation completes, remove the animation class
+                        if (e.animationName.includes('fadeIn')) {
+                            this.classList.remove('animate-fadeInUp', 'animate-fadeInRight', 'animate-fadeInLeft');
+                        }
+                    });
+                });
+            }
+            
+            // Setup animations after a short delay to ensure DOM is ready
+            setTimeout(setupAnimations, 2000);
+
+            // Add event listeners to all buttons that should trigger the spinner
+            setTimeout(function(){
+                // Login and Proceed buttons with spinner
+                const loginBtn = document.querySelector('button:contains("Login")');
+                const proceedBtn = document.querySelector('button:contains("Proceed")');
+                
+                if (loginBtn) {
+                    loginBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when login button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                if (proceedBtn) {
+                    proceedBtn.addEventListener("click", function() {
+                        showSpinner();  // Show spinner when proceed button is clicked
+                        
+                        if (!this.classList.contains("loading")) {
+                            const originalText = this.textContent;
+                            this.setAttribute("data-original-text", originalText);
+                            this.textContent = "";
+                            this.classList.add("loading");
+                            
+                            // Create spinner inside button
+                            const btnSpinner = document.createElement("div");
+                            btnSpinner.className = "btn-spinner";
+                            btnSpinner.style.width = "20px";
+                            btnSpinner.style.height = "20px";
+                            btnSpinner.style.border = "3px solid rgba(255,255,255,0.3)";
+                            btnSpinner.style.borderRadius = "50%";
+                            btnSpinner.style.borderTopColor = "#fff";
+                            btnSpinner.style.animation = "spin 1s linear infinite";
+                            btnSpinner.style.display = "inline-block";
+                            btnSpinner.style.verticalAlign = "middle";
+                            this.appendChild(btnSpinner);
+                            
+                            // Reset button after 3 seconds if no response
+                            setTimeout(() => {
+                                if (this.classList.contains("loading")) {
+                                    this.classList.remove("loading");
+                                    this.textContent = this.getAttribute("data-original-text");
+                                }
+                                hideSpinner();  // Hide spinner after timeout
+                            }, 3000);
+                        }
+                    });
+                }
+                
+                // Scale effect for dashboard buttons
+                const dashboardButtons = document.querySelectorAll('.menu-button, button:contains("Back to Dashboard")');
+                dashboardButtons.forEach(function(btn) {
+                    btn.addEventListener("click", function() {
+                        this.style.transform = "scale(1.1)";
+                        setTimeout(() => {
+                            this.style.transform = "";
+                        }, 200);
+                    });
+                });
+            }, 2000);
+            
+            // Add keyframes for spinner animation
+            const style = document.createElement('style');
+            style.textContent = `
+                @keyframes spin {
+                    0% { transform: rotate(0deg); }
+                    100% { transform: rotate(360deg); }
+                }
+            `;
+            document.head.appendChild(style);
+        });
+        </script>
+        ''')
+
+        # Logo for all pages - positioned in top-left corner
+        gr.HTML('''
+        <div class="logo-dashboard">
+            <!-- USIU Logo Placeholder - Replace with actual logo path -->
+            <img src="week5/chatbot_prototype/images/usiu-logo.png" alt="USIU Logo" class="logo" />
+        </div>
+        ''')
+
+        # Define containers for different views with initial animation state
+        dashboard_container = gr.Column(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInUp")
+        general_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        login_container = gr.Column(visible=False, elem_classes="container floating-card login-form-container pre-animation")
+        study_container = gr.Column(visible=False, elem_classes="chat-container pre-animation")
+        
+        # Logout Button Component for Study Support (initially hidden)
+        with gr.Column(visible=False) as logout_component:
+            # Session information display (hidden textbox for now)
+            current_user = gr.Textbox(visible=False)
+            # Create a dedicated logout button with custom styling
+            logout_btn = gr.Button("Logout", elem_classes="logout-btn")
+            # An additional HTML component for JS updates (used in the Proceed callback)
+            js_update = gr.HTML("", visible=False)
+        
+        # ------------- Dashboard View -------------
+        with dashboard_container:
+            gr.Markdown("<h1 class='with-logo'>AI Assistance Dashboard</h1>")
+            with gr.Column(elem_classes="dashboard-menu"):
+                gen_button = gr.Button("General Enquiries", elem_classes="menu-button")
+                study_button = gr.Button("Study with AI", elem_classes="menu-button")
+        
+        # ------------- General Academic Chat View -------------
+        with general_container:
+            back_gen = gr.Button("Back to Dashboard")
+            general_chat_component.render()
+        
+        # ------------- Login Form (for Study Support) View -------------
+        with login_container:
+            login_form_component.render()
+        
+        # ------------- Study Support Chat View -------------
+        with study_container:
+            back_study = gr.Button("Back to Dashboard")
+            study_support_component.render()
+            
+            # Set session ID for the study chat interface
+            # This ensures the session is refreshed on user interaction
+            session_id_for_study = gr.Textbox(visible=False)
+        
+        # ------------- Navigation Callbacks -------------
+        # When "General Academic Chat" is selected from the dashboard.
+        gen_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False)  # Hide logout component
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container, logout_component]
+        )
+        
+        # When "Study Support Chat" is selected from the dashboard, show the login view with animation.
+        study_button.click(
+            lambda: [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=True, elem_classes="container floating-card login-form-container animate-fadeInRight"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False)  # Hide logout component
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container, logout_component]
+        )
+        
+        # "Back to Dashboard" buttons with animation.
+        back_gen.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False)  # Hide logout component
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container, logout_component]
+        )
+        
+        back_study.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False)  # Hide logout component
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container, logout_component]
+        )
+        
+        login_back_btn.click(
+            lambda: [
+                gr.update(visible=True, elem_classes="container floating-card dashboard-card animate-fadeInLeft"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False)  # Hide logout component
+            ],
+            outputs=[dashboard_container, general_container, login_container, study_container, logout_component]
+        )
+        
+        # ------------- Authentication Logic -------------
+        login_btn.click(
+            handle_login,
+            inputs=[user_id_input, password_input],
+            outputs=[login_msg, user_id_error, password_error, proceed_btn, login_btn, session_id]
+        )
+        
+        # When "Proceed" is clicked (after successful authentication), show the study support chat with animation.
+        def proceed_to_study(session_id_value):
+            # Get user info from the session
+            session = get_session(session_id_value)
+            user_email = session["user_id"] if session else "Guest"
+            
+            # Updated JS code wrapped in <script> tags to update the user email display.
+            js_code = f"<script>document.getElementById('user-email').textContent = '{user_email}';</script>"
+            
+            # Start tracking activity for this session
+            update_session_activity(session_id_value)
+            
+            return [
+                gr.update(visible=False),
+                gr.update(visible=False, elem_classes="chat-container pre-animation"),
+                gr.update(visible=False, elem_classes="container floating-card login-form-container pre-animation"),
+                gr.update(visible=True, elem_classes="chat-container animate-fadeInRight"),
+                gr.update(visible=True),  # Show logout component
+                user_email,              # Update current user display
+                session_id_value,        # Pass session ID to the study chat interface
+                js_code                 # Update the new HTML component (js_update)
+            ]
+        
+        proceed_btn.click(
+            proceed_to_study,
+            inputs=[session_id],
+            outputs=[
+                dashboard_container, 
+                general_container, 
+                login_container, 
+                study_container, 
+                logout_component,
+                current_user,
+                session_id_for_study,
+                js_update  # Replaces gr.JavaScript.update()
+            ]
+        )
+        
+        # Logout button functionality – using the dedicated logout button (logout_btn)
+        logout_btn.click(
+            handle_logout,
+            inputs=[session_id],
+            outputs=[dashboard_container, general_container, login_container, study_container]
+        )
+        
+        # NOTE: Removed the .change() callback on the ChatInterface (study_support_component)
+        # because ChatInterface objects do not support the .change() method.
+        # Session activity is now updated within the chat callback of study_support_chat.
+        
+    return dashboard.queue()