Fix model download issue: Make Manim/Kokoro dependencies optional for HF Spaces

huggingface_spaces_app.py

@@ -41,10 +41,20 @@ def initialize_video_generator():
     
     try:
         if DEMO_MODE:
-            return "✅ Demo mode enabled"
+            return "✅ Demo mode enabled - No heavy dependencies loaded"
         
-        from generate_video import VideoGenerator
-        from mllm_tools.litellm import LiteLLMWrapper
+        # Check if we have API keys before importing heavy dependencies
+        gemini_keys = os.getenv("GEMINI_API_KEY", "")
+        if not gemini_keys:
+            return "⚠️ No API keys found - running in demo mode (prevents model downloads)"
+        
+        # Try to import but handle missing dependencies gracefully
+        try:
+            from generate_video import VideoGenerator
+            from mllm_tools.litellm import LiteLLMWrapper
+        except ImportError as import_err:
+            print(f"Heavy dependencies not available: {import_err}")
+            return "⚠️ Heavy dependencies not installed - using demo mode to prevent downloads"
         
         planner_model = LiteLLMWrapper(
             model_name="gemini/gemini-2.0-flash",
@@ -65,11 +75,12 @@ def initialize_video_generator():
             verbose=False
         )
         
-        return "✅ Video generator initialized"
+        return "✅ Video generator initialized with full dependencies"
         
     except Exception as e:
         CAN_IMPORT_DEPENDENCIES = False
-        return f"⚠️ Running in demo mode: {str(e)}"
+        print(f"Initialization error: {e}")
+        return f"⚠️ Running in demo mode to prevent model downloads: {str(e)[:100]}..."
 
 def simulate_video_generation(topic: str, context: str, max_scenes: int, progress_callback=None):
     """Simulate video generation."""
@@ -206,12 +217,15 @@ def create_interface():
         if DEMO_MODE:
             gr.HTML("""
             <div style="background: #fff3cd; padding: 15px; border-radius: 5px; margin: 10px 0;">
-                <h3>⚠️ Demo Mode</h3>
+                <h3>⚠️ Demo Mode - Preventing Model Downloads</h3>
+                <p>This prevents automatic downloading of Kokoro and other heavy models.</p>
                 <p>To enable full functionality:</p>
                 <ul>
                     <li>Set <code>GEMINI_API_KEY</code> (supports comma-separated keys)</li>
                     <li>Set <code>DEMO_MODE=false</code></li>
+                    <li>Install full dependencies (manim, manim-voiceover, etc.)</li>
                 </ul>
+                <p><strong>Note:</strong> Full mode requires ~2GB of model downloads.</p>
             </div>
             """)
         

requirements_hf.txt

@@ -17,9 +17,10 @@ elevenlabs>=1.0.0
 # Utility libraries
 tqdm>=4.62.0
 
-# Optional dependencies for full functionality
-# These will be installed if available, but the app will work without them
-manim; python_version>="3.8"
-pydub>=0.25.0; python_version>="3.8"
-moviepy>=1.0.3; python_version>="3.8"
-soundfile>=0.12.0; python_version>="3.8" 
+# Video processing dependencies (only install when needed)
+# Comment out these lines to prevent heavy downloads on Hugging Face Spaces
+# manim; python_version>="3.8"
+# manim-voiceover; python_version>="3.8"
+# pydub>=0.25.0; python_version>="3.8" 
+# moviepy>=1.0.3; python_version>="3.8"
+# soundfile>=0.12.0; python_version>="3.8" 

requirements_hf_minimal.txt

@@ -0,0 +1,18 @@
+# Minimal dependencies for Hugging Face Spaces demo
+gradio==4.44.0
+python-dotenv>=0.19.0
+requests>=2.25.0
+numpy>=1.21.0
+
+# AI/ML dependencies (lightweight)
+litellm>=1.0.0
+google-generativeai>=0.8.0
+
+# Basic image processing
+pillow>=8.3.0
+
+# Utility libraries
+tqdm>=4.62.0
+
+# Optional TTS (only if ELEVENLABS_API_KEY is set)
+elevenlabs>=1.0.0