Add time estimate hint to Step 1 in Gradio UI (~3-4 mins)

app.py

@@ -440,13 +440,13 @@ def reset_workflow():
 
 def add_production_wrapper(video_file, mood_override, enable_smart_crop, add_intro_image, add_subtitles, progress=gr.Progress()):
     """Production via Modal - uploads video and processes with fresh job_id"""
-    
+
     # Debug: Log what we received from Gradio
     logger.info(f"video_file type: {type(video_file)}")
     logger.info(f"video_file value: {video_file}")
-    
+
     actual_video_path = None
-    
+
     # Handle different Gradio 6 input formats
     if video_file is None:
         if workflow_state.get('final_video_path'):
@@ -460,7 +460,8 @@ def add_production_wrapper(video_file, mood_override, enable_smart_crop, add_int
         actual_video_path = video_file
     elif isinstance(video_file, dict):
         # Gradio 6 may return dict with 'path' or 'name' key
-        actual_video_path = video_file.get('path') or video_file.get('name') or video_file.get('video')
+        actual_video_path = video_file.get('path') or video_file.get(
+            'name') or video_file.get('video')
         logger.info(f"Extracted path from dict: {actual_video_path}")
     elif hasattr(video_file, 'name'):
         # File-like object
@@ -468,7 +469,7 @@ def add_production_wrapper(video_file, mood_override, enable_smart_crop, add_int
     else:
         yield f"❌ Unexpected video input type: {type(video_file)}", None
         return
-    
+
     if not actual_video_path:
         yield "❌ Could not determine video file path", None
         return
@@ -487,35 +488,37 @@ def add_production_wrapper(video_file, mood_override, enable_smart_crop, add_int
     try:
         progress(0.1, desc="Preparing video...")
         yield "📤 Preparing video for processing...", None
-        
+
         # Copy file to our temp directory to prevent Gradio cleanup issues
         import shutil
         import uuid
-        
+
         temp_dir = os.path.join(os.getcwd(), "temp")
         os.makedirs(temp_dir, exist_ok=True)
-        
+
         # Generate a unique filename
         temp_filename = f"upload_{uuid.uuid4().hex[:8]}_{os.path.basename(actual_video_path)}"
         local_video_path = os.path.join(temp_dir, temp_filename)
-        
+
         logger.info(f"Copying uploaded file to: {local_video_path}")
         shutil.copy2(actual_video_path, local_video_path)
-        
+
         # Get the file size for logging
         file_size = os.path.getsize(local_video_path) / 1024 / 1024
-        logger.info(f"Processing video: {local_video_path} ({file_size:.1f} MB)")
+        logger.info(
+            f"Processing video: {local_video_path} ({file_size:.1f} MB)")
 
         # Read video as base64 for transfer to Modal
         progress(0.2, desc="Reading video file...")
         yield "📦 Reading video file...", None
-        
+
         with open(local_video_path, 'rb') as f:
             video_bytes = f.read()
         video_base64 = base64.b64encode(video_bytes).decode('utf-8')
-        
-        logger.info(f"Video encoded: {len(video_base64) / 1024 / 1024:.1f} MB base64")
-        
+
+        logger.info(
+            f"Video encoded: {len(video_base64) / 1024 / 1024:.1f} MB base64")
+
         progress(0.3, desc="Processing on Modal...")
         yield "🎬 Processing on Modal (this may take a few minutes)...", None
 
@@ -665,22 +668,22 @@ def add_production_to_video(
 ) -> str:
     """
     🎬 MAIN VIDEO PROCESSING TOOL - Transform any video into viral-ready content!
-    
+
     ⚠️ IMPORTANT: This tool requires a WEB URL (http:// or https://), NOT a local file path!
     - ✅ YouTube URLs work: https://youtube.com/watch?v=...
     - ✅ Direct video URLs work: https://example.com/video.mp4
     - ❌ Local paths do NOT work: /mnt/data/file.mp4
-    
+
     If the user uploads a file, tell them to:
     1. Upload the video to YouTube (unlisted) and provide the URL, OR
     2. Use a cloud storage link (Google Drive public link, Dropbox, etc.)
-    
+
     This is the PRIMARY tool for video editing. Use this tool when the user wants to:
     - Process a YouTube video
     - Add professional production value to a video
     - Create short-form vertical content for TikTok/Reels/Shorts
     - Add intros, subtitles, smart crop, or background music
-    
+
     The tool automatically:
     1. Downloads the video from the URL
     2. Applies AI-powered 9:16 smart crop for mobile viewing
@@ -688,7 +691,7 @@ def add_production_to_video(
     4. Adds auto-generated subtitles using Whisper
     5. Adds mood-matched background music
     6. Returns a download link for the finished video
-    
+
     Parameters:
         video_url: The WEB URL of the video (must start with http:// or https://)
                    - YouTube URL: https://youtube.com/watch?v=VIDEO_ID
@@ -697,7 +700,7 @@ def add_production_to_video(
         enable_smart_crop: If True, crops video to 9:16 vertical format for mobile
         add_intro: If True, generates AI intro with voiceover and title card
         add_subtitles: If True, adds auto-generated subtitles
-    
+
     Returns:
         Processing result with a download URL for the produced video
     """
@@ -705,16 +708,17 @@ def add_production_to_video(
         # Validate URL - must be a web URL, not a local path
         if not video_url:
             return "❌ Error: No video URL provided"
-            
+
         # Check for local file paths (reject these)
         if video_url.startswith('/mnt/data/') or video_url.startswith('/tmp/') or video_url.startswith('C:\\'):
             return f"❌ Error: Local file path detected.\n\n⚠️ This tool requires a web URL, not a local file.\n\n**Options:**\n1. Use the Video Studio widget to upload files directly\n2. Upload to YouTube (unlisted) and share the URL\n3. Use a cloud storage link (Google Drive, Dropbox)"
-            
+
         if not video_url.startswith(('http://', 'https://')):
             return f"❌ Error: Invalid URL '{video_url[:50]}...'\n\n⚠️ This tool requires a web URL (http:// or https://), not a local file path.\n\n**Please provide:**\n- A YouTube URL: https://youtube.com/watch?v=...\n- Or a direct video URL: https://example.com/video.mp4\n\nIf you uploaded a file, please upload it to YouTube (unlisted) first and share that URL."
-        
-        logger.info(f"🎬 Production pipeline starting for: {video_url[:100]}...")
-        
+
+        logger.info(
+            f"🎬 Production pipeline starting for: {video_url[:100]}...")
+
         # Call Modal Step 6 with video_url for standalone mode
         response = call_modal("step", data={
             "step": 6,
@@ -724,18 +728,18 @@ def add_production_to_video(
             "add_intro": add_intro,
             "add_subtitles": add_subtitles,
         }, timeout=2400)  # 40 min timeout for large videos
-        
+
         if response.get("error"):
             return f"❌ Error: {response['error']}"
-        
+
         if response.get("success"):
             job_id = response.get('job_id')
             duration = response.get('duration', 0)
             detected_mood = response.get('mood', mood)
-            
+
             # Build download URL
             download_url = f"https://tayyabkhn343--directors-cut-download.modal.run?job_id={job_id}"
-            
+
             result = f"""✅ Video produced successfully!
 
 📊 **Details:**
@@ -748,11 +752,11 @@ def add_production_to_video(
 - Background Music: {'✓' if response.get('has_music') else '✗'}
 
 🔗 **Download:** {download_url}"""
-            
+
             return result
         else:
             return f"❌ Processing failed: {response.get('error', 'Unknown error')}"
-            
+
     except Exception as e:
         logger.error(f"Production pipeline error: {e}")
         return f"❌ Error: {str(e)}"
@@ -1251,19 +1255,19 @@ def video_studio_widget_html():
 def open_video_studio() -> str:
     """
     🎬 Open the Director's Cut Video Studio interface.
-    
+
     Use this tool when the user wants to:
     - Process or edit a video
     - Upload a video file
     - Add production value to any video
     - Create viral short-form content
-    
+
     This opens an interactive studio where users can:
     - Paste a YouTube URL OR upload a video file directly
     - Choose mood (hype, chill, suspense, or auto-detect)
     - Enable/disable smart crop, AI intro, and subtitles
     - Process the video and download the result
-    
+
     Returns:
         str: Confirmation that the studio is ready
     """
@@ -1291,6 +1295,7 @@ with gr.Blocks(title="Director's Cut") as app:
             # Step 1
             with gr.Group():
                 gr.Markdown("### Step 1: Analyze Video")
+                gr.Markdown("*Downloads video & extracts transcript (~3-4 mins)*", elem_classes=["step-hint"])
                 step1_btn = gr.Button(
                     "1️⃣ Analyze & Classify", variant="primary")
                 step1_output = gr.Markdown()
@@ -1376,35 +1381,40 @@ with gr.Blocks(title="Director's Cut") as app:
         with gr.Tab("🤖 ChatGPT Integration", visible=False):
             # This tab binds MCP tools and resources to Gradio events
             # Required by Gradio MCP to expose them to ChatGPT
-            
+
             # Bind the add_production_to_video tool
             chatgpt_url_input = gr.Textbox(label="Video URL")
-            chatgpt_mood = gr.Dropdown(choices=["auto", "hype", "suspense", "chill"], value="auto")
+            chatgpt_mood = gr.Dropdown(
+                choices=["auto", "hype", "suspense", "chill"], value="auto")
             chatgpt_crop = gr.Checkbox(value=True)
             chatgpt_intro = gr.Checkbox(value=True)
             chatgpt_subs = gr.Checkbox(value=True)
             chatgpt_output = gr.Textbox(label="Result")
             chatgpt_btn = gr.Button("Process Video")
             chatgpt_btn.click(
-                add_production_to_video, 
-                inputs=[chatgpt_url_input, chatgpt_mood, chatgpt_crop, chatgpt_intro, chatgpt_subs],
+                add_production_to_video,
+                inputs=[chatgpt_url_input, chatgpt_mood,
+                        chatgpt_crop, chatgpt_intro, chatgpt_subs],
                 outputs=chatgpt_output
             )
-            
+
             # Bind the production widget resource
-            widget_code = gr.Code(label="Widget HTML", language="html", max_lines=5)
+            widget_code = gr.Code(label="Widget HTML",
+                                  language="html", max_lines=5)
             widget_btn = gr.Button("Show Widget")
             widget_btn.click(production_widget_html, outputs=widget_code)
-            
+
             # Bind the Video Studio tool
             studio_output = gr.Textbox(label="Studio Status")
             studio_btn = gr.Button("Open Video Studio")
             studio_btn.click(open_video_studio, outputs=studio_output)
-            
+
             # Bind the Video Studio widget resource
-            studio_widget_code = gr.Code(label="Video Studio Widget", language="html", max_lines=5)
+            studio_widget_code = gr.Code(
+                label="Video Studio Widget", language="html", max_lines=5)
             studio_widget_btn = gr.Button("Get Video Studio Widget")
-            studio_widget_btn.click(video_studio_widget_html, outputs=studio_widget_code)
+            studio_widget_btn.click(
+                video_studio_widget_html, outputs=studio_widget_code)
 
 
 if __name__ == "__main__":