Upload 14 files

README.md

@@ -0,0 +1,12 @@
+---
+title: agent-shark-v2
+emoji: 🐳
+colorFrom: blue
+colorTo: gray
+sdk: static
+pinned: false
+tags:
+  - deepsite
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app (3).py

@@ -0,0 +1,37 @@
+with gr.Blocks() as demo:
+    gr.Markdown("# 🦈 AgentShark AI Assistant\nWelcome to your advanced business growth partner!")
+
+    with gr.Row():
+        audio_in = gr.Audio(type="file", label="🎤 Upload audio (optional)")
+        text_in = gr.Textbox(label="💬 Or type your message", placeholder="What can we help with today?", lines=1)
+
+    with gr.Row():
+        avatar_in = gr.Image(type="file", label="🖼️ Upload Avatar Image (optional)")
+
+    with gr.Accordion("⚙️ Advanced Settings", open=False):
+        model_choice = gr.Radio(["OpenAI GPT-4o", "Claude 3 Opus", "Mistral-7B"], value="OpenAI GPT-4o", label="Select LLM")
+        tone = gr.Dropdown(["advisor", "hype", "soft", "playful"], value="advisor", label="Assistant Tone")
+
+    lead_stage_display = gr.Textbox(label="🧭 Current Lead Stage", interactive=False)
+    response_out = gr.Textbox(label="💡 Agent Response", interactive=False)
+    audio_out = gr.Audio(label="🔊 Voice Response")
+    video_out = gr.Video(label="🎥 Avatar Video")
+    state = gr.State({})
+
+    send_btn = gr.Button("💬 Send Message")
+    send_btn.click(
+        process_input,
+        inputs=[audio_in, text_in, model_choice, tone, avatar_in, state],
+        outputs=[response_out, audio_out, video_out, lead_stage_display, state]
+    )
+
+    with gr.Row():
+        gr.Markdown("### 📤 Export your conversation")
+        export_json_btn = gr.Button("Export as JSON")
+        export_csv_btn = gr.Button("Export as CSV")
+
+    export_json_btn.click(export_json, inputs=[state], outputs=[gr.File(label="Download JSON")])
+    export_csv_btn.click(export_csv, inputs=[state], outputs=[gr.File(label="Download CSV")])
+
+if __name__ == "__main__":
+    demo.launch()

avatar.py

@@ -0,0 +1,25 @@
+import subprocess
+import uuid
+import os
+
+def generate_avatar_video(audio_path, avatar_image, emotion="neutral"):
+    # Placeholder for generating a video avatar (e.g., SadTalker or ffmpeg with image+audio)
+    output_filename = f"avatar_{uuid.uuid4().hex}.mp4"
+    
+    # Using ffmpeg to create a simple video combining static image and audio
+    ffmpeg_cmd = [
+        "ffmpeg",
+        "-loop", "1",
+        "-i", avatar_image,
+        "-i", audio_path,
+        "-c:v", "libx264",
+        "-tune", "stillimage",
+        "-c:a", "aac",
+        "-b:a", "192k",
+        "-shortest",
+        "-pix_fmt", "yuv420p",
+        output_filename
+    ]
+    subprocess.run(ffmpeg_cmd, check=True)
+    
+    return output_filename

conversation_storage.py

@@ -0,0 +1,26 @@
+import json
+import pandas as pd
+import os
+from datetime import datetime
+
+def save_conversation_to_json(user_id, conversation, folder="conversations"):
+    os.makedirs(folder, exist_ok=True)
+    filename = f"{folder}/conversation_{user_id}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.json"
+    with open(filename, "w") as f:
+        json.dump(conversation, f, indent=2)
+    return filename
+
+def save_conversation_to_csv(user_id, conversation, folder="conversations"):
+    os.makedirs(folder, exist_ok=True)
+    filename = f"{folder}/conversation_{user_id}_{datetime.now().strftime('%Y%m%d_%H%M%S')}.csv"
+    rows = []
+    for msg in conversation:
+        rows.append({
+            "timestamp": datetime.now().strftime("%Y-%m-%d %H:%M:%S"),
+            "user_id": user_id,
+            "role": msg["role"],
+            "content": msg["content"]
+        })
+    df = pd.DataFrame(rows)
+    df.to_csv(filename, index=False)
+    return filename

emotion_detection.py

@@ -0,0 +1,24 @@
+import torch
+from transformers import pipeline
+import logging
+
+logger = logging.getLogger("emotion_detection")
+logger.setLevel(logging.INFO)
+
+try:
+    # Using a popular emotion detection model from Hugging Face
+    emotion_classifier = pipeline("text-classification", model="j-hartmann/emotion-english-distilroberta-base", return_all_scores=False)
+    logger.info("Emotion detection model initialized successfully")
+except Exception as e:
+    logger.warning(f"Failed to load emotion detection model: {e}")
+    emotion_classifier = None
+
+def get_primary_emotion(text):
+    if not emotion_classifier:
+        return "neutral"
+    try:
+        result = emotion_classifier(text)
+        return result[0]["label"].lower()
+    except Exception as e:
+        logger.warning(f"Emotion detection failed: {e}")
+        return "neutral"

gitattributes

@@ -0,0 +1,35 @@
+*.7z filter=lfs diff=lfs merge=lfs -text
+*.arrow filter=lfs diff=lfs merge=lfs -text
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.bz2 filter=lfs diff=lfs merge=lfs -text
+*.ckpt filter=lfs diff=lfs merge=lfs -text
+*.ftz filter=lfs diff=lfs merge=lfs -text
+*.gz filter=lfs diff=lfs merge=lfs -text
+*.h5 filter=lfs diff=lfs merge=lfs -text
+*.joblib filter=lfs diff=lfs merge=lfs -text
+*.lfs.* filter=lfs diff=lfs merge=lfs -text
+*.mlmodel filter=lfs diff=lfs merge=lfs -text
+*.model filter=lfs diff=lfs merge=lfs -text
+*.msgpack filter=lfs diff=lfs merge=lfs -text
+*.npy filter=lfs diff=lfs merge=lfs -text
+*.npz filter=lfs diff=lfs merge=lfs -text
+*.onnx filter=lfs diff=lfs merge=lfs -text
+*.ot filter=lfs diff=lfs merge=lfs -text
+*.parquet filter=lfs diff=lfs merge=lfs -text
+*.pb filter=lfs diff=lfs merge=lfs -text
+*.pickle filter=lfs diff=lfs merge=lfs -text
+*.pkl filter=lfs diff=lfs merge=lfs -text
+*.pt filter=lfs diff=lfs merge=lfs -text
+*.pth filter=lfs diff=lfs merge=lfs -text
+*.rar filter=lfs diff=lfs merge=lfs -text
+*.safetensors filter=lfs diff=lfs merge=lfs -text
+saved_model/**/* filter=lfs diff=lfs merge=lfs -text
+*.tar.* filter=lfs diff=lfs merge=lfs -text
+*.tar filter=lfs diff=lfs merge=lfs -text
+*.tflite filter=lfs diff=lfs merge=lfs -text
+*.tgz filter=lfs diff=lfs merge=lfs -text
+*.wasm filter=lfs diff=lfs merge=lfs -text
+*.xz 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

index.html

@@ -0,0 +1,715 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>AgentSharkDemo | Multimodal AI Agent</title>
+    <script src="https://cdn.tailwindcss.com"></script>
+    <link rel="stylesheet" href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/6.4.0/css/all.min.css">
+    <style>
+        @keyframes sharkSwim {
+            0% { transform: translateX(0) rotate(0deg); }
+            25% { transform: translateX(50px) rotate(5deg); }
+            50% { transform: translateX(100px) rotate(0deg); }
+            75% { transform: translateX(50px) rotate(-5deg); }
+            100% { transform: translateX(0) rotate(0deg); }
+        }
+        .shark-animation {
+            animation: sharkSwim 8s infinite ease-in-out;
+        }
+        .gradient-bg {
+            background: linear-gradient(135deg, #f9a8d4 0%, #93c5fd 100%);
+        }
+        .chat-bubble:before {
+            content: '';
+            position: absolute;
+            left: -8px;
+            top: 15px;
+            width: 0;
+            height: 0;
+            border-top: 8px solid transparent;
+            border-right: 16px solid #e2e8f0;
+            border-bottom: 8px solid transparent;
+        }
+        .agent-bubble:before {
+            left: auto;
+            right: -8px;
+            border-right: none;
+            border-left: 16px solid #3b82f6;
+        }
+        .waveform {
+            display: flex;
+            height: 40px;
+            align-items: flex-end;
+            gap: 2px;
+        }
+        .waveform-bar {
+            width: 3px;
+            background: #3b82f6;
+            border-radius: 3px;
+            transition: height 0.2s ease-in-out;
+        }
+        .lead-stage {
+            transition: all 0.3s ease;
+        }
+        .lead-stage.active {
+            transform: scale(1.1);
+            box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
+        }
+    </style>
+</head>
+<body class="bg-gray-50 min-h-screen font-sans">
+    <!-- Header -->
+    <header class="gradient-bg text-white shadow-lg">
+        <div class="container mx-auto px-4 py-6">
+            <div class="flex flex-col md:flex-row justify-between items-center">
+                <div class="flex items-center space-x-4 mb-4 md:mb-0">
+                    <div class="relative w-16 h-16">
+                        <img src="https://em-content.zobj.net/thumbs/160/apple/325/shark_1f988.png" 
+                             class="shark-animation absolute w-full h-full object-contain" 
+                             alt="AgentShark Logo">
+                    </div>
+                    <h1 class="text-2xl md:text-3xl font-bold">Agent<span class="text-blue-200">Shark</span>Demo</h1>
+                </div>
+                <div class="flex space-x-4">
+                    <a href="#features" class="px-4 py-2 rounded-lg hover:bg-white/20 transition">Features</a>
+                    <a href="#demo" class="px-4 py-2 rounded-lg hover:bg-white/20 transition">Demo</a>
+                    <a href="#about" class="px-4 py-2 rounded-lg hover:bg-white/20 transition">About</a>
+                </div>
+            </div>
+        </div>
+    </header>
+
+    <!-- Hero Section -->
+    <section class="gradient-bg text-white py-16">
+        <div class="container mx-auto px-4 text-center">
+            <h2 class="text-4xl md:text-5xl font-bold mb-6">Multimodal AI for Business Growth</h2>
+            <p class="text-xl md:text-2xl mb-8 max-w-3xl mx-auto">
+                Engage leads with voice, text, and animated avatar responses in real-time
+            </p>
+            <div class="flex flex-wrap justify-center gap-4 mb-12">
+                <div class="bg-white/10 backdrop-blur-md rounded-full px-6 py-2 flex items-center">
+                    <i class="fas fa-microphone-alt mr-2 text-blue-200"></i> Voice I/O
+                </div>
+                <div class="bg-white/10 backdrop-blur-md rounded-full px-6 py-2 flex items-center">
+                    <i class="fas fa-comment-dots mr-2 text-pink-200"></i> Text Chat
+                </div>
+                <div class="bg-white/10 backdrop-blur-md rounded-full px-6 py-2 flex items-center">
+                    <i class="fas fa-robot mr-2 text-indigo-200"></i> Animated Avatar
+                </div>
+                <div class="bg-white/10 backdrop-blur-md rounded-full px-6 py-2 flex items-center">
+                    <i class="fas fa-chart-line mr-2 text-green-200"></i> Lead Tracking
+                </div>
+            </div>
+            <button id="tryDemoBtn" class="bg-white text-pink-600 hover:bg-gray-100 font-bold py-3 px-8 rounded-full text-lg transition-all transform hover:scale-105 shadow-lg">
+                Try Live Demo <i class="fas fa-play ml-2"></i>
+            </button>
+        </div>
+    </section>
+
+    <!-- Features Section -->
+    <section id="features" class="py-16 bg-white">
+        <div class="container mx-auto px-4">
+            <h2 class="text-3xl font-bold text-center mb-12 text-gray-800">Powerful Features for Business Growth</h2>
+            
+            <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
+                <!-- Feature 1 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-blue-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-blue-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-brain text-blue-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Agentic Behavior</h3>
+                    <p class="text-gray-600">
+                        Understands context and intent with vector memory, adapting dynamically to lead conversion stages in real-time.
+                    </p>
+                </div>
+                
+                <!-- Feature 2 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-pink-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-pink-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-exchange-alt text-pink-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Multimodal I/O</h3>
+                    <p class="text-gray-600">
+                        Voice and text input with emotional detection, plus animated avatar video responses for engaging interactions.
+                    </p>
+                </div>
+                
+                <!-- Feature 3 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-indigo-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-indigo-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-rocket text-indigo-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Model Flexibility</h3>
+                    <p class="text-gray-600">
+                        Choose between GPT-4o, Claude 3 Opus, or Mistral API with seamless fallback to local LLMs for reliability.
+                    </p>
+                </div>
+                
+                <!-- Feature 4 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-green-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-green-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-user-tie text-green-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Lead Conversion</h3>
+                    <p class="text-gray-600">
+                        Tracks visitors through awareness, interest, decision, and action stages with tailored guidance at each step.
+                    </p>
+                </div>
+                
+                <!-- Feature 5 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-purple-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-purple-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-file-export text-purple-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Data Export</h3>
+                    <p class="text-gray-600">
+                        Export conversations to JSON or CSV with full analytics and no database dependencies - simple file-based memory.
+                    </p>
+                </div>
+                
+                <!-- Feature 6 -->
+                <div class="bg-gray-50 rounded-xl p-6 border border-gray-200 hover:border-yellow-300 transition-all hover:shadow-lg">
+                    <div class="w-14 h-14 bg-yellow-100 rounded-full flex items-center justify-center mb-4">
+                        <i class="fas fa-sliders-h text-yellow-600 text-2xl"></i>
+                    </div>
+                    <h3 class="text-xl font-bold mb-2 text-gray-800">Customizable</h3>
+                    <p class="text-gray-600">
+                        Modular codebase with beautiful Gradio interface and advanced settings for easy extension and customization.
+                    </p>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Demo Section -->
+    <section id="demo" class="py-16 bg-gray-100">
+        <div class="container mx-auto px-4">
+            <h2 class="text-3xl font-bold text-center mb-12 text-gray-800">Interactive Demo</h2>
+            
+            <div class="bg-white rounded-xl shadow-lg overflow-hidden">
+                <div class="md:flex">
+                    <!-- Chat Interface -->
+                    <div class="md:w-2/3 p-6">
+                        <div class="flex items-center justify-between mb-6">
+                            <h3 class="text-xl font-bold text-gray-800">Conversation with AgentShark</h3>
+                            <div class="flex items-center space-x-2">
+                                <div class="h-3 w-3 rounded-full bg-green-500"></div>
+                                <span class="text-sm text-gray-500">Online</span>
+                            </div>
+                        </div>
+                        
+                        <!-- Lead Stages -->
+                        <div class="flex justify-between mb-6">
+                            <div class="lead-stage bg-blue-50 text-blue-800 rounded-lg px-4 py-2 text-center w-1/4 mx-1 cursor-pointer" data-stage="awareness">
+                                <div class="text-xs font-semibold">Awareness</div>
+                                <div class="h-1 w-full bg-gray-200 mt-1 rounded-full">
+                                    <div class="h-1 bg-blue-300 rounded-full w-1/4"></div>
+                                </div>
+                            </div>
+                            <div class="lead-stage bg-blue-50 text-blue-800 rounded-lg px-4 py-2 text-center w-1/4 mx-1 cursor-pointer" data-stage="interest">
+                                <div class="text-xs font-semibold">Interest</div>
+                                <div class="h-1 w-full bg-gray-200 mt-1 rounded-full">
+                                    <div class="h-1 bg-blue-300 rounded-full w-0"></div>
+                                </div>
+                            </div>
+                            <div class="lead-stage bg-blue-50 text-blue-800 rounded-lg px-4 py-2 text-center w-1/4 mx-1 cursor-pointer" data-stage="decision">
+                                <div class="text-xs font-semibold">Decision</div>
+                                <div class="h-1 w-full bg-gray-200 mt-1 rounded-full">
+                                    <div class="h-1 bg-blue-300 rounded-full w-0"></div>
+                                </div>
+                            </div>
+                            <div class="lead-stage bg-blue-50 text-blue-800 rounded-lg px-4 py-2 text-center w-1/4 mx-1 cursor-pointer" data-stage="action">
+                                <div class="text-xs font-semibold">Action</div>
+                                <div class="h-1 w-full bg-gray-200 mt-1 rounded-full">
+                                    <div class="h-1 bg-blue-300 rounded-full w-0"></div>
+                                </div>
+                            </div>
+                        </div>
+                        
+                        <!-- Chat Area -->
+                        <div class="h-96 overflow-y-auto mb-4 space-y-4" id="chatArea">
+                            <div class="flex justify-start">
+                                <div class="max-w-xs md:max-w-md lg:max-w-lg bg-gray-100 rounded-xl p-4 relative chat-bubble">
+                                    <p class="text-gray-800">Hello! I'm AgentShark, your AI business growth assistant. How can I help you today?</p>
+                                </div>
+                            </div>
+                        </div>
+                        
+                        <!-- Input Area -->
+                        <div class="border-t pt-4">
+                            <div class="flex items-center space-x-2 mb-2">
+                                <button class="bg-blue-100 hover:bg-blue-200 text-blue-600 p-2 rounded-full transition" id="voiceBtn">
+                                    <i class="fas fa-microphone"></i>
+                                </button>
+                                <div class="relative flex-grow">
+                                    <input type="text" id="userInput" placeholder="Type your message here..." 
+                                           class="w-full border border-gray-300 rounded-full py-2 px-4 focus:outline-none focus:ring-2 focus:ring-blue-300 focus:border-transparent">
+                                    <button class="absolute right-3 top-1/2 transform -translate-y-1/2 text-gray-400 hover:text-blue-500">
+                                        <i class="far fa-smile"></i>
+                                    </button>
+                                </div>
+                                <button class="bg-blue-600 hover:bg-blue-700 text-white p-2 rounded-full transition" id="sendBtn">
+                                    <i class="fas fa-paper-plane"></i>
+                                </button>
+                            </div>
+                            <div class="flex items-center justify-between text-sm text-gray-500 px-2">
+                                <div id="voiceStatus" class="hidden items-center">
+                                    <div class="waveform mr-2" id="waveform">
+                                        <div class="waveform-bar h-5"></div>
+                                        <div class="waveform-bar h-8"></div>
+                                        <div class="waveform-bar h-12"></div>
+                                        <div class="waveform-bar h-6"></div>
+                                        <div class="waveform-bar h-10"></div>
+                                        <div class="waveform-bar h-7"></div>
+                                        <div class="waveform-bar h-4"></div>
+                                    </div>
+                                    <span>Listening...</span>
+                                </div>
+                                <div class="flex items-center">
+                                    <span class="mr-1">Model:</span>
+                                    <select class="bg-gray-100 rounded px-2 py-1 border border-gray-200 text-xs">
+                                        <option>GPT-4o</option>
+                                        <option>Claude 3 Opus</option>
+                                        <option>Mistral API</option>
+                                        <option>Local LLM</option>
+                                    </select>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    
+                    <!-- Avatar & Settings -->
+                    <div class="md:w-1/3 bg-gray-800 text-white p-6">
+                        <div class="text-center mb-6">
+                            <h3 class="text-xl font-bold mb-4">Animated Avatar</h3>
+                            <div class="bg-black aspect-square rounded-lg overflow-hidden flex items-center justify-center mb-4 bg-gradient-to-br from-blue-900 to-purple-900">
+                                <div class="relative w-40 h-40">
+                                    <img src="https://em-content.zobj.net/thumbs/160/apple/325/shark_1f988.png" 
+                                         class="w-full h-full object-contain filter brightness-125" 
+                                         id="avatarImage">
+                                    <div class="absolute inset-0 bg-blue-400 opacity-10 rounded-full animate-pulse"></div>
+                                </div>
+                            </div>
+                            <div class="flex justify-center space-x-4 mb-4">
+                                <button class="bg-blue-600 hover:bg-blue-700 text-white px-4 py-2 rounded-lg">
+                                    <i class="fas fa-play mr-1"></i> Generate
+                                </button>
+                                <button class="bg-gray-700 hover:bg-gray-600 text-white px-4 py-2 rounded-lg">
+                                    <i class="fas fa-download mr-1"></i> Save
+                                </button>
+                            </div>
+                        </div>
+                        
+                        <div class="mb-6">
+                            <h4 class="font-bold mb-2">Response Type</h4>
+                            <div class="grid grid-cols-3 gap-2">
+                                <button class="bg-blue-600 text-white py-2 rounded-lg">Text</button>
+                                <button class="bg-gray-700 hover:bg-gray-600 text-white py-2 rounded-lg">Voice</button>
+                                <button class="bg-gray-700 hover:bg-gray-600 text-white py-2 rounded-lg">Both</button>
+                            </div>
+                        </div>
+                        
+                        <div class="mb-6">
+                            <h4 class="font-bold mb-2">Personality</h4>
+                            <select class="w-full bg-gray-700 text-white rounded-lg px-3 py-2 border border-gray-600">
+                                <option>Professional</option>
+                                <option>Friendly</option>
+                                <option>Enthusiastic</option>
+                                <option>Technical</option>
+                                <option>Consultative</option>
+                            </select>
+                        </div>
+                        
+                        <div>
+                            <h4 class="font-bold mb-2">Export Conversation</h4>
+                            <div class="flex space-x-2">
+                                <button class="flex-1 bg-green-600 hover:bg-green-700 text-white py-2 rounded-lg">
+                                    <i class="fas fa-file-code mr-1"></i> JSON
+                                </button>
+                                <button class="flex-1 bg-green-600 hover:bg-green-700 text-white py-2 rounded-lg">
+                                    <i class="fas fa-file-csv mr-1"></i> CSV
+                                </button>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- About Section -->
+    <section id="about" class="py-16 bg-white">
+        <div class="container mx-auto px-4">
+            <div class="max-w-4xl mx-auto">
+                <h2 class="text-3xl font-bold text-center mb-8 text-gray-800">About AgentSharkDemo</h2>
+                
+                <div class="bg-gray-50 rounded-xl p-6 md:p-8 shadow-md border border-gray-200">
+                    <p class="text-gray-700 mb-4">
+                        <span class="font-bold">AgentSharkDemo</span> is a cutting-edge multimodal AI agent developed for the <span class="text-blue-600">Hugging Face MCP Agents Hackathon</span>. It combines advanced natural language processing with voice interaction capabilities and animated avatar responses to create an engaging, human-like conversational experience.
+                    </p>
+                    
+                    <p class="text-gray-700 mb-4">
+                        Built with a focus on <span class="text-pink-600">business growth and lead conversion</span>, AgentSharkDemo intelligently guides visitors through the customer journey from initial awareness to final action. The system tracks conversation context, emotional tone, and progress through sales funnel stages to deliver tailored responses.
+                    </p>
+                    
+                    <div class="bg-blue-50 border-l-4 border-blue-500 p-4 mb-6">
+                        <p class="text-blue-800 font-semibold">
+                            <i class="fas fa-lightbulb text-blue-500 mr-2"></i> The project demonstrates real-time multimodal AI in a single, fully integrated interface - no external databases required with its innovative file-based memory system.
+                        </p>
+                    </div>
+                    
+                    <p class="text-gray-700">
+                        Whether deployed on Hugging Face Spaces for easy sharing or integrated into business workflows, AgentSharkDemo offers a flexible solution for engaging customers with the latest advancements in AI technology.
+                    </p>
+                </div>
+                
+                <div class="mt-8 text-center">
+                    <a href="https://github.com/yourusername/agentsharkdemo" 
+                       class="inline-flex items-center bg-gray-800 hover:bg-gray-700 text-white px-6 py-3 rounded-lg transition">
+                        <i class="fab fa-github mr-2"></i> View on GitHub
+                    </a>
+                </div>
+            </div>
+        </div>
+    </section>
+
+    <!-- Footer -->
+    <footer class="bg-gray-900 text-white py-8">
+        <div class="container mx-auto px-4">
+            <div class="flex flex-col md:flex-row justify-between items-center">
+                <div class="flex items-center mb-4 md:mb-0">
+                    <div class="w-10 h-10 mr-2">
+                        <img src="https://em-content.zobj.net/thumbs/160/apple/325/shark_1f988.png" 
+                             class="w-full h-full object-contain" 
+                             alt="Shark Logo">
+                    </div>
+                    <div>
+                        <h3 class="font-bold text-xl">Agent<span class="text-blue-300">Shark</span>Demo</h3>
+                        <p class="text-sm text-gray-400">Multimodal AI for Business Growth</p>
+                    </div>
+                </div>
+                
+                <div class="flex space-x-4 mb-4 md:mb-0">
+                    <a href="#" class="text-gray-400 hover:text-white transition">
+                        <i class="fab fa-twitter text-xl"></i>
+                    </a>
+                    <a href="#" class="text-gray-400 hover:text-white transition">
+                        <i class="fab fa-linkedin text-xl"></i>
+                    </a>
+                    <a href="#" class="text-gray-400 hover:text-white transition">
+                        <i class="fab fa-github text-xl"></i>
+                    </a>
+                    <a href="#" class="text-gray-400 hover:text-white transition">
+                        <i class="fab fa-discord text-xl"></i>
+                    </a>
+                </div>
+                
+                <div class="text-gray-400 text-sm">
+                    &copy; 2023 AgentSharkDemo. Built for Hugging Face MCP Agents Hackathon.
+                </div>
+            </div>
+        </div>
+    </footer>
+
+    <!-- Modal -->
+    <div id="demoModal" class="fixed inset-0 bg-black bg-opacity-50 flex items-center justify-center z-50 hidden">
+        <div class="bg-white rounded-xl shadow-2xl w-full max-w-4xl max-h-[90vh] overflow-hidden">
+            <div class="flex justify-between items-center border-b p-4">
+                <h3 class="text-xl font-bold text-gray-800">Live Demo Instructions</h3>
+                <button id="closeModalBtn" class="text-gray-500 hover:text-gray-700">
+                    <i class="fas fa-times"></i>
+                </button>
+            </div>
+            <div class="p-6 overflow-y-auto" style="max-height: calc(90vh - 120px)">
+                <div class="flex flex-col md:flex-row gap-6">
+                    <div class="md:w-1/2">
+                        <h4 class="font-bold text-lg mb-3 text-gray-700">How to Interact</h4>
+                        <div class="space-y-4">
+                            <div class="flex items-start">
+                                <div class="bg-blue-100 text-blue-800 rounded-full w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
+                                    <i class="fas fa-microphone-alt"></i>
+                                </div>
+                                <div>
+                                    <h5 class="font-semibold text-gray-800">Voice Interaction</h5>
+                                    <p class="text-gray-600 text-sm">Click the microphone button to speak. AgentShark will transcribe and respond instantly.</p>
+                                </div>
+                            </div>
+                            <div class="flex items-start">
+                                <div class="bg-indigo-100 text-indigo-800 rounded-full w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
+                                    <i class="fas fa-keyboard"></i>
+                                </div>
+                                <div>
+                                    <h5 class="font-semibold text-gray-800">Text Input</h5>
+                                    <p class="text-gray-600 text-sm">Type your message and hit send for text-based conversation with the AI agent.</p>
+                                </div>
+                            </div>
+                            <div class="flex items-start">
+                                <div class="bg-green-100 text-green-800 rounded-full w-8 h-8 flex items-center justify-center flex-shrink-0 mr-3">
+                                    <i class="fas fa-robot"></i>
+                                </div>
+                                <div>
+                                    <h5 class="font-semibold text-gray-800">Avatar Response</h5>
+                                    <p class="text-gray-600 text-sm">Watch the animated avatar respond with synchronized lip movements and expressions.</p>
+                                </div>
+                            </div>
+                        </div>
+                    </div>
+                    <div class="md:w-1/2">
+                        <h4 class="font-bold text-lg mb-3 text-gray-700">Business Features</h4>
+                        <div class="space-y-3">
+                            <div class="bg-gray-50 p-3 rounded-lg">
+                                <h5 class="font-semibold text-gray-800 flex items-center">
+                                    <span class="w-4 h-4 bg-blue-500 rounded-full mr-2"></span>
+                                    Lead Stage Tracking
+                                </h5>
+                                <p class="text-gray-600 text-sm mt-1">
+                                    The progress bar shows movement through awareness, interest, decision, and action stages.
+                                </p>
+                            </div>
+                            <div class="bg-gray-50 p-3 rounded-lg">
+                                <h5 class="font-semibold text-gray-800 flex items-center">
+                                    <span class="w-4 h-4 bg-purple-500 rounded-full mr-2"></span>
+                                    Multimodal Analytics
+                                </h5>
+                                <p class="text-gray-600 text-sm mt-1">
+                                    Export full conversation logs with voice transcripts, text history, and lead stage data.
+                                </p>
+                            </div>
+                            <div class="bg-gray-50 p-3 rounded-lg">
+                                <h5 class="font-semibold text-gray-800 flex items-center">
+                                    <span class="w-4 h-4 bg-yellow-500 rounded-full mr-2"></span>
+                                    Model Switching
+                                </h5>
+                                <p class="text-gray-600 text-sm mt-1">
+                                    Toggle between different AI models to find the best fit for your business needs.
+                                </p>
+                            </div>
+                        </div>
+                    </div>
+                </div>
+            </div>
+            <div class="border-t p-4 bg-gray-50 flex justify-end">
+                <button id="startDemoBtn" class="bg-blue-600 hover:bg-blue-700 text-white px-6 py-2 rounded-lg transition">
+                    Start Demo <i class="fas fa-arrow-right ml-2"></i>
+                </button>
+            </div>
+        </div>
+    </div>
+
+    <script>
+        document.addEventListener('DOMContentLoaded', function() {
+            // Modal handling
+            const demoModal = document.getElementById('demoModal');
+            const tryDemoBtn = document.getElementById('tryDemoBtn');
+            const closeModalBtn = document.getElementById('closeModalBtn');
+            const startDemoBtn = document.getElementById('startDemoBtn');
+            
+            tryDemoBtn.addEventListener('click', function() {
+                demoModal.classList.remove('hidden');
+            });
+            
+            closeModalBtn.addEventListener('click', function() {
+                demoModal.classList.add('hidden');
+            });
+            
+            startDemoBtn.addEventListener('click', function() {
+                demoModal.classList.add('hidden');
+                document.getElementById('demo').scrollIntoView({ behavior: 'smooth' });
+            });
+            
+            // Voice button animation
+            const voiceBtn = document.getElementById('voiceBtn');
+            const voiceStatus = document.getElementById('voiceStatus');
+            const waveformBars = document.querySelectorAll('.waveform-bar');
+            
+            voiceBtn.addEventListener('click', function() {
+                voiceBtn.classList.toggle('bg-red-500');
+                voiceBtn.classList.toggle('hover:bg-red-600');
+                voiceBtn.classList.toggle('text-white');
+                
+                if (voiceBtn.classList.contains('bg-red-500')) {
+                    voiceStatus.classList.remove('hidden');
+                    voiceBtn.innerHTML = '<i class="fas fa-microphone-slash"></i>';
+                    
+                    // Animate waveform bars
+                    waveformBars.forEach(bar => {
+                        setInterval(() => {
+                            bar.style.height = `${Math.random() * 30 + 5}px`;
+                        }, 200);
+                    });
+                } else {
+                    voiceStatus.classList.add('hidden');
+                    voiceBtn.innerHTML = '<i class="fas fa-microphone"></i>';
+                }
+            });
+            
+            // Chat functionality
+            const sendBtn = document.getElementById('sendBtn');
+            const userInput = document.getElementById('userInput');
+            const chatArea = document.getElementById('chatArea');
+            
+            function sendMessage() {
+                const message = userInput.value.trim();
+                if (message === '') return;
+                
+                // Add user message
+                const userHtml = `
+                    <div class="flex justify-end">
+                        <div class="max-w-xs md:max-w-md lg:max-w-lg bg-blue-600 text-white rounded-xl p-4 relative agent-bubble">
+                            <p>${message}</p>
+                        </div>
+                    </div>
+                `;
+                chatArea.insertAdjacentHTML('beforeend', userHtml);
+                
+                // Clear input
+                userInput.value = '';
+                
+                // Show typing indicator
+                const typingHtml = `
+                    <div class="flex justify-start">
+                        <div class="max-w-xs md:max-w-md lg:max-w-lg bg-gray-100 rounded-xl p-4 relative chat-bubble">
+                            <div class="flex space-x-2">
+                                <div class="w-2 h-2 bg-gray-400 rounded-full animate-bounce"></div>
+                                <div class="w-2 h-2 bg-gray-400 rounded-full animate-bounce" style="animation-delay: 0.2s"></div>
+                                <div class="w-2 h-2 bg-gray-400 rounded-full animate-bounce" style="animation-delay: 0.4s"></div>
+                            </div>
+                        </div>
+                    </div>
+                `;
+                chatArea.insertAdjacentHTML('beforeend', typingHtml);
+                
+                // Scroll to bottom
+                chatArea.scrollTop = chatArea.scrollHeight;
+                
+                // Simulate response after delay
+                setTimeout(() => {
+                    // Remove typing indicator
+                    chatArea.removeChild(chatArea.lastChild);
+                    
+                    // Add response
+                    const responses = [
+                        "I understand your question about our services. We offer several packages that might suit your needs.",
+                        "That's an excellent point. Based on what you've said, I'd recommend our premium solution for your business size.",
+                        "Thank you for your inquiry! I've analyzed your requirements and our Enterprise package seems most appropriate.",
+                        "I notice you're in the 'Interest' stage of our funnel. Would you like me to send you some case studies?",
+                        "Based on our conversation, you're making great progress toward a decision. Shall we discuss pricing options now?"
+                    ];
+                    
+                    const randomResponse = responses[Math.floor(Math.random() * responses.length)];
+                    
+                    const responseHtml = `
+                        <div class="flex justify-start">
+                            <div class="max-w-xs md:max-w-md lg:max-w-lg bg-gray-100 rounded-xl p-4 relative chat-bubble">
+                                <p>${randomResponse}</p>
+                            </div>
+                        </div>
+                    `;
+                    chatArea.insertAdjacentHTML('beforeend', responseHtml);
+                    
+                    // Scroll to bottom again
+                    chatArea.scrollTop = chatArea.scrollHeight;
+                    
+                    // Randomly animate avatar
+                    if (Math.random() > 0.5) {
+                        const avatar = document.getElementById('avatarImage');
+                        avatar.classList.add('animate-bounce');
+                        setTimeout(() => {
+                            avatar.classList.remove('animate-bounce');
+                        }, 2000);
+                    }
+                    
+                    // Randomly advance lead stage
+                    if (Math.random() > 0.7) {
+                        advanceLeadStage();
+                    }
+                }, 1500 + Math.random() * 2000);
+            }
+            
+            sendBtn.addEventListener('click', sendMessage);
+            
+            userInput.addEventListener('keypress', function(e) {
+                if (e.key === 'Enter') {
+                    sendMessage();
+                }
+            });
+            
+            // Lead stage functionality
+            const leadStages = document.querySelectorAll('.lead-stage');
+            
+            function advanceLeadStage() {
+                let foundCurrent = false;
+                let nextElement = null;
+                
+                leadStages.forEach((stage, index) => {
+                    if (!foundCurrent && stage.classList.contains('active')) {
+                        stage.classList.remove('active');
+                        foundCurrent = true;
+                        const progress = stage.querySelector('.bg-blue-300');
+                        progress.style.width = '100%';
+                        
+                        if (index < leadStages.length - 1) {
+                            nextElement = leadStages[index + 1];
+                        }
+                    }
+                });
+                
+                if (!foundCurrent) {
+                    nextElement = leadStages[0];
+                }
+                
+                if (nextElement) {
+                    nextElement.classList.add('active');
+                    const progress = nextElement.querySelector('.bg-blue-300');
+                    progress.style.width = '25%';
+                    
+                    // Update avatar for stage change
+                    const avatar = document.getElementById('avatarImage');
+                    avatar.classList.add('animate-pulse');
+                    setTimeout(() => {
+                        avatar.classList.remove('animate-pulse');
+                    }, 1000);
+                }
+            }
+            
+            // Initialize first lead stage
+            leadStages[0].classList.add('active');
+            const firstProgress = leadStages[0].querySelector('.bg-blue-300');
+            firstProgress.style.width = '25%';
+            
+            // Click on lead stages
+            leadStages.forEach(stage => {
+                stage.addEventListener('click', function() {
+                    leadStages.forEach(s => s.classList.remove('active'));
+                    this.classList.add('active');
+                });
+            });
+            
+            // Mobile menu toggle (if needed)
+            const mobileMenuBtn = document.querySelector('.mobile-menu-button');
+            const mobileMenu = document.querySelector('.mobile-menu');
+            
+            if (mobileMenuBtn) {
+                mobileMenuBtn.addEventListener('click', function() {
+                    mobileMenu.classList.toggle('hidden');
+                });
+            }
+            
+            // Animate shark logo in header on hover
+            const headerShark = document.querySelector('header .shark-animation');
+            if (headerShark) {
+                headerShark.addEventListener('mouseover', function() {
+                    this.style.animationPlayState = 'running';
+                });
+                
+                headerShark.addEventListener('animationiteration', function() {
+                    if (!this.matches(':hover')) {
+                        this.style.animationPlayState = 'paused';
+                    }
+                });
+            }
+        });
+    </script>
+<p style="border-radius: 8px; text-align: center; font-size: 12px; color: #fff; margin-top: 16px;position: fixed; left: 8px; bottom: 8px; z-index: 10; background: rgba(0, 0, 0, 0.8); padding: 4px 8px;">Made with <img src="https://enzostvs-deepsite.hf.space/logo.svg" alt="DeepSite Logo" style="width: 16px; height: 16px; vertical-align: middle;display:inline-block;margin-right:3px;filter:brightness(0) invert(1);"><a href="https://enzostvs-deepsite.hf.space" style="color: #fff;text-decoration: underline;" target="_blank" >DeepSite</a> - 🧬 <a href="https://enzostvs-deepsite.hf.space?remix=OSOCONSULT/agent-shark-v2" style="color: #fff;text-decoration: underline;" target="_blank" >Remix</a></p></body>
+</html>

memory.py

@@ -0,0 +1,43 @@
+import os
+import json
+
+class FileMemory:
+    def __init__(self, base_path="memory_data"):
+        self.base_path = base_path
+        os.makedirs(self.base_path, exist_ok=True)
+
+    def _get_file_path(self, user_id):
+        return os.path.join(self.base_path, f"{user_id}.json")
+
+    def get_memory(self, user_id):
+        path = self._get_file_path(user_id)
+        if os.path.exists(path):
+            with open(path, "r") as f:
+                return json.load(f)
+        return []
+
+    def store_user_message(self, user_id, message):
+        memory = self.get_memory(user_id)
+        memory.append({"role": "user", "content": message})
+        self._save_memory(user_id, memory)
+
+    def store_agent_message(self, user_id, message):
+        memory = self.get_memory(user_id)
+        memory.append({"role": "assistant", "content": message})
+        self._save_memory(user_id, memory)
+
+    def clear_memory(self, user_id):
+        path = self._get_file_path(user_id)
+        if os.path.exists(path):
+            os.remove(path)
+
+    def _save_memory(self, user_id, memory):
+        path = self._get_file_path(user_id)
+        with open(path, "w") as f:
+            json.dump(memory, f, indent=2)
+
+    def get_context(self, user_id, max_turns=10):
+        memory = self.get_memory(user_id)
+        return "\n".join([f"{m['role'].upper()}: {m['content']}" for m in memory[-max_turns:]])
+
+memory = FileMemory()

prompts.txt

@@ -0,0 +1 @@
+--- title: AGENTSHARKDEMO emoji: ⚡ colorFrom: pink colorTo: blue sdk: gradio sdk_version: 5.33.0 app_file: app.py pinned: false license: apache-2.0 short_description: ' multimodal, agentic AI demo for business growth and leads' --- # 🦈 AgentSharkDemo: Multimodal AI Agent for Business Growth  **AgentSharkDemo** is a cutting-edge, multimodal AI agent built for the **Hugging Face MCP Agents Hackathon**! It combines voice, text, and animated avatar responses to deliver an engaging, human-like conversational experience for business growth and lead conversion.  ---  ## 🚀 Demo Overview  ✅ **Agentic Behavior**   - Understands voice and text input   - Detects emotion and intent in real-time   - Uses vector memory for context-aware responses   - Dynamically adapts to lead conversion stages   - Generates dynamic audio and animated avatar video responses  ✅ **Multimodal Power**   - 🎤 Voice input with real-time transcription (Whisper)   - 💬 Text input and conversational context   - 🔊 Voice output via XTTS/Bark TTS   - 🎥 Animated avatar videos (AnimateDiff-ready)  ✅ **Model Choice Flexibility**   - **OpenAI GPT-4o**   - **Claude 3 Opus (Anthropic)**   - **Hugging Face Mistral Inference API**   - Local LLM fallback for reliable answers  ✅ **File-Based Export & Analytics**   - Exports conversations to JSON and CSV   - No database needed — file-based memory for simplicity!  ---  ## 💡 Key Features for Judges  - 🏆 Demonstrates **real-time multimodal AI** in a single, fully integrated Gradio app   - 📈 **Business-focused**: tracks and guides visitors through lead stages   - 💡 Uses **streaming responses** for faster interactions   - 🪄 AnimateDiff-ready avatar video generation   - 🗂️ Clean and modular codebase for easy extension   - 🎨 Beautiful Gradio interface with advanced settings in accordions  ---  ## 🌐 Deployment  ✅ **Hugging Face Spaces** (Gradio template)   ✅ **No YAML needed** — just upload your `.env` secrets and these files!  ---  ## ⚙️ Local Testing  ```bash pip install -r requirements.txt python app.py

requirements (1).txt

@@ -0,0 +1,13 @@
+gradio>=3.41.2
+openai
+requests
+numpy
+pandas
+pydub
+librosa
+opencv-python-headless
+Pillow
+chromadb
+python-dotenv
+transformers
+torch

style.css

@@ -0,0 +1,28 @@
+body {
+	padding: 2rem;
+	font-family: -apple-system, BlinkMacSystemFont, "Arial", sans-serif;
+}
+
+h1 {
+	font-size: 16px;
+	margin-top: 0;
+}
+
+p {
+	color: rgb(107, 114, 128);
+	font-size: 15px;
+	margin-bottom: 10px;
+	margin-top: 5px;
+}
+
+.card {
+	max-width: 620px;
+	margin: 0 auto;
+	padding: 16px;
+	border: 1px solid lightgray;
+	border-radius: 16px;
+}
+
+.card p:last-child {
+	margin-bottom: 0;
+}

tts_worker.py

@@ -0,0 +1,18 @@
+from pydub import AudioSegment
+from gtts import gTTS
+import os
+import uuid
+
+def save_tts(text, emotion="neutral"):
+    # Use Google TTS as a simple fallback for demonstration.
+    tts = gTTS(text, lang="en")
+    output_filename = f"output_{uuid.uuid4().hex}.mp3"
+    tts.save(output_filename)
+
+    # Convert to WAV (if needed)
+    audio = AudioSegment.from_file(output_filename, format="mp3")
+    wav_filename = output_filename.replace(".mp3", ".wav")
+    audio.export(wav_filename, format="wav")
+    os.remove(output_filename)
+
+    return wav_filename

utils.py

@@ -0,0 +1,69 @@
+import os
+import requests
+from dotenv import load_dotenv
+from pydub import AudioSegment
+import tempfile
+from openai import OpenAI
+
+load_dotenv()
+HF_API_URL = os.getenv("HF_API_URL")
+HF_API_KEY = os.getenv("HF_API_KEY")
+OPENAI_API_KEY = os.getenv("OPENAI_API_KEY")
+openai_client = OpenAI(api_key=OPENAI_API_KEY)
+
+def transcribe_audio(file_path):
+    try:
+        audio = AudioSegment.from_file(file_path)
+        audio = audio.set_frame_rate(16000).set_channels(1)
+        temp_wav = tempfile.NamedTemporaryFile(suffix=".wav", delete=False)
+        audio.export(temp_wav.name, format="wav")
+        with open(temp_wav.name, "rb") as f:
+            response = openai_client.audio.transcriptions.create(
+                file=f,
+                model="whisper-1"
+            )
+        os.remove(temp_wav.name)
+        return response.text
+    except Exception as e:
+        return f"Error in transcription: {e}"
+
+def generate_response(prompt, tone="advisor", model="OpenAI GPT-4o", stream=False):
+    try:
+        if model == "OpenAI GPT-4o":
+            completion = openai_client.chat.completions.create(
+                model="gpt-4o",
+                messages=[
+                    {"role": "system", "content": f"You are an {tone} expert assistant."},
+                    {"role": "user", "content": prompt}
+                ]
+            )
+            return completion.choices[0].message.content.strip()
+
+        elif model == "Claude 3 Opus":
+            headers = {
+                "x-api-key": os.getenv("CLAUDE_API_KEY"),
+                "anthropic-version": "2023-06-01"
+            }
+            data = {
+                "model": "claude-3-opus-20240229",
+                "messages": [{"role": "user", "content": prompt}]
+            }
+            response = requests.post(
+                "https://api.anthropic.com/v1/messages",
+                headers=headers,
+                json=data
+            )
+            return response.json()["content"][0]["text"].strip()
+
+        elif model == "Mistral-7B":
+            headers = {"Authorization": f"Bearer {HF_API_KEY}"}
+            data = {"inputs": prompt}
+            response = requests.post(HF_API_URL, headers=headers, json=data)
+            response.raise_for_status()
+            return response.json()[0]["generated_text"].strip()
+
+        else:
+            return "⚠️ Invalid model selection."
+
+    except Exception as e:
+        return f"Error generating response: {e}"

vector_memory.py

@@ -0,0 +1,30 @@
+import os
+import logging
+
+try:
+    import chromadb
+    from chromadb.config import Settings
+    CHROMADB_AVAILABLE = True
+except ImportError:
+    CHROMADB_AVAILABLE = False
+
+logger = logging.getLogger("vector_memory")
+logger.setLevel(logging.INFO)
+
+def add_to_vector_memory(user_id, text, metadata=None):
+    if not CHROMADB_AVAILABLE:
+        logger.warning("ChromaDB not available. Skipping vector memory storage.")
+        return
+    # Placeholder: Implement vector memory logic here.
+    logger.info(f"Storing vector memory for user: {user_id}")
+
+def get_relevant_context(user_id, query, top_k=3):
+    if not CHROMADB_AVAILABLE:
+        logger.warning("ChromaDB not available. Returning empty relevant context.")
+        return ""
+    # Placeholder: Implement search for relevant context.
+    return ""
+
+def clear_vector_memory(user_id):
+    if not CHROMADB_AVAILABLE:
+        logger.warning("ChromaDB not available. Skipping vector memory clear.")