Update app.py

app.py

@@ -1,43 +1,54 @@
 """
-TinkerIQ Main Application
-AI-powered maker assistant with circuit analysis, code generation, and component recommendations
+TinkerIQ Main Application with BOM Integration
+AI-powered maker assistant with circuit analysis, code generation, component recommendations, and professional BOM management
 """
 
 import gradio as gr
 import os
-from dotenv import load_dotenv
-from datetime import datetime
+import pandas as pd
 import json
-from bom_writer import BOMWriter
+from datetime import datetime
+from dotenv import load_dotenv
+from typing import List, Dict, Optional, Tuple
 
 # Import TinkerIQ modules
 try:
     from component_search import RealComponentSearch
     from vision_analysis import AdvancedVisionAnalysis
     from code_generator import SmartCodeGenerator
+    from bom_writer import BOMWriter
 except ImportError as e:
     raise ImportError(f"Module import failed: {e}")
 
 load_dotenv()
 
 class TinkerIQApp:
-    """Main TinkerIQ application orchestrator"""
+    """Main TinkerIQ application orchestrator with BOM integration"""
     
     def __init__(self):
-        print("🧠 Initializing TinkerIQ Application...")
+        print("🧠 Initializing TinkerIQ Application with BOM Writer...")
         
         # Initialize core modules
         self.component_search = RealComponentSearch()
         self.vision_analysis = AdvancedVisionAnalysis()
         self.code_generator = SmartCodeGenerator()
+        self.bom_writer = BOMWriter()
         
-        # Application state for session management
+        # Enhanced application state
         self.session_state = {
             "last_analysis": None,
             "last_components": None,
             "last_code": None,
+            "current_bom": None,
+            "bom_history": [],
             "conversation_count": 0,
-            "preferred_provider": "auto"
+            "preferred_provider": "auto",
+            "project_info": {
+                "name": "Untitled Project",
+                "version": "1.0",
+                "description": "",
+                "created": datetime.now().isoformat()
+            }
         }
         
         # Available AI providers
@@ -51,8 +62,8 @@ class TinkerIQApp:
         
         print(f"✅ TinkerIQ initialized with {sum(self.ai_providers.values())} AI providers available")
     
-    def analyze_circuit_complete(self, image_path, user_message="", analysis_type="detailed"):
-        """Complete circuit analysis workflow"""
+    def analyze_circuit_complete(self, image_path: str, user_message: str = "", analysis_type: str = "detailed") -> Dict:
+        """Complete circuit analysis workflow with BOM integration"""
         try:
             if not image_path:
                 return {
@@ -60,7 +71,7 @@ class TinkerIQApp:
                     "message": "Please upload a circuit image to analyze."
                 }
             
-            print(f"🔍 Starting circuit analysis...")
+            print("🔍 Starting circuit analysis...")
             
             # Perform vision analysis
             analysis_result = self.vision_analysis.analyze_image(image_path, analysis_type)
@@ -72,6 +83,11 @@ class TinkerIQApp:
                 try:
                     components_result = self.component_search.get_contextual_components(analysis_result["analysis"])
                     self.session_state["last_components"] = components_result
+                    
+                    # Auto-generate BOM from components
+                    if components_result and components_result.get("components"):
+                        self._create_bom_from_components(components_result)
+                        
                 except Exception as e:
                     print(f"Component search error: {e}")
                     components_result = None
@@ -94,7 +110,43 @@ class TinkerIQApp:
                 "message": f"Analysis failed: {str(e)}"
             }
     
-    def generate_code_complete(self, user_message, platform=None):
+    def _create_bom_from_components(self, components_result: Dict) -> None:
+        """Create BOM from component search results"""
+        try:
+            project_name = self.session_state["project_info"]["name"]
+            circuit_type = components_result.get("circuit_type", "unknown")
+            
+            # Convert components to BOM format
+            bom_components = []
+            for i, comp in enumerate(components_result.get("components", []), 1):
+                bom_component = {
+                    "item": i,
+                    "quantity": 1,
+                    "part_number": comp.get("part_number", ""),
+                    "description": comp.get("name", ""),
+                    "manufacturer": comp.get("manufacturer", comp.get("supplier", "")),
+                    "supplier": comp.get("supplier", ""),
+                    "unit_price": comp.get("price", "$0.00"),
+                    "total_price": comp.get("price", "$0.00"),
+                    "datasheet": comp.get("datasheet", ""),
+                    "notes": comp.get("description", "")[:100]
+                }
+                bom_components.append(bom_component)
+            
+            # Create BOM
+            bom_data = self.bom_writer.create_bom(
+                project_name=project_name,
+                components=bom_components,
+                circuit_type=circuit_type
+            )
+            
+            self.session_state["current_bom"] = bom_data
+            print(f"✅ BOM created with {len(bom_components)} components")
+            
+        except Exception as e:
+            print(f"❌ BOM creation error: {e}")
+    
+    def generate_code_complete(self, user_message: str, platform: Optional[str] = None) -> Dict:
         """Complete code generation workflow"""
         try:
             if not self.session_state.get("last_analysis"):
@@ -104,8 +156,7 @@ class TinkerIQApp:
                 }
             
             analysis_text = self.session_state["last_analysis"]["analysis"]
-            
-            print(f"💻 Generating code...")
+            print("💻 Generating code...")
             
             code_result = self.code_generator.generate_code(analysis_text, user_message, platform)
             
@@ -121,27 +172,166 @@ class TinkerIQApp:
                 "message": f"Code generation failed: {str(e)}"
             }
     
-    def get_components(self):
+    def get_components(self) -> Dict:
         """Get component recommendations"""
         if self.session_state.get("last_components"):
             return self.session_state["last_components"]
         return {"components": [], "circuit_type": "unknown"}
     
-    def reset_session(self):
+    def reset_session(self) -> str:
         """Reset session state"""
         self.session_state = {
             "last_analysis": None,
             "last_components": None,
             "last_code": None,
+            "current_bom": None,
+            "bom_history": [],
             "conversation_count": 0,
-            "preferred_provider": "auto"
+            "preferred_provider": "auto",
+            "project_info": {
+                "name": "Untitled Project",
+                "version": "1.0",
+                "description": "",
+                "created": datetime.now().isoformat()
+            }
         }
         return "Session reset! Ready for new analysis."
 
 # Initialize the application
 tinkeriq_app = TinkerIQApp()
 
-def format_analysis_response(analysis_data):
+# BOM Management Functions
+def get_current_bom_data() -> Tuple[pd.DataFrame, str]:
+    """Get current BOM as DataFrame and summary"""
+    try:
+        current_bom = tinkeriq_app.session_state.get("current_bom")
+        if not current_bom:
+            empty_df = pd.DataFrame(columns=[
+                "Item", "Qty", "Part Number", "Description", 
+                "Manufacturer", "Supplier", "Unit Price", "Total Price"
+            ])
+            return empty_df, "No BOM available. Please analyze a circuit first."
+        
+        # Convert BOM to DataFrame
+        components = current_bom.get("components", [])
+        df_data = []
+        
+        for comp in components:
+            df_data.append([
+                comp.get("item", ""),
+                comp.get("quantity", 1),
+                comp.get("part_number", ""),
+                comp.get("description", ""),
+                comp.get("manufacturer", ""),
+                comp.get("supplier", ""),
+                comp.get("unit_price", "$0.00"),
+                comp.get("total_price", "$0.00")
+            ])
+        
+        df = pd.DataFrame(df_data, columns=[
+            "Item", "Qty", "Part Number", "Description",
+            "Manufacturer", "Supplier", "Unit Price", "Total Price"
+        ])
+        
+        # Generate summary
+        total_items = len(components)
+        project_name = current_bom.get("project_name", "Unknown Project")
+        total_cost = current_bom.get("total_cost", "$0.00")
+        
+        summary = f"""**{project_name}** BOM Summary:
+• **Total Components:** {total_items}
+• **Estimated Cost:** {total_cost}
+• **Generated:** {current_bom.get('created', 'Unknown')}
+• **Circuit Type:** {current_bom.get('circuit_type', 'Unknown').replace('_', ' ').title()}"""
+        
+        return df, summary
+        
+    except Exception as e:
+        print(f"Error getting BOM data: {e}")
+        empty_df = pd.DataFrame()
+        return empty_df, f"Error loading BOM: {str(e)}"
+
+def export_bom(format_type: str, export_method: str, **kwargs) -> str:
+    """Export BOM in specified format and method"""
+    try:
+        current_bom = tinkeriq_app.session_state.get("current_bom")
+        if not current_bom:
+            return "❌ No BOM available to export. Please analyze a circuit first."
+        
+        # Export based on format
+        if format_type == "CSV":
+            result = tinkeriq_app.bom_writer.export_csv(current_bom)
+        elif format_type == "JSON":
+            result = tinkeriq_app.bom_writer.export_json(current_bom)
+        elif format_type == "PDF":
+            result = tinkeriq_app.bom_writer.export_pdf(current_bom)
+        else:
+            return f"❌ Unsupported format: {format_type}"
+        
+        if result.get("success"):
+            file_path = result.get("file_path")
+            
+            # Handle export method
+            if export_method == "Download":
+                return f"✅ BOM exported successfully! File saved: {file_path}"
+            
+            elif export_method == "Email":
+                email = kwargs.get("email", "")
+                if email:
+                    email_result = tinkeriq_app.bom_writer.send_email(
+                        to_email=email,
+                        subject=f"BOM Export - {current_bom.get('project_name', 'Project')}",
+                        file_path=file_path
+                    )
+                    if email_result.get("success"):
+                        return f"✅ BOM emailed successfully to {email}!"
+                    else:
+                        return f"❌ Email failed: {email_result.get('message', 'Unknown error')}"
+                else:
+                    return "❌ Email address required for email export."
+            
+            elif export_method == "GitHub":
+                repo = kwargs.get("github_repo", "")
+                if repo:
+                    github_result = tinkeriq_app.bom_writer.save_to_github(
+                        file_path=file_path,
+                        repo_name=repo,
+                        commit_message=f"Add BOM for {current_bom.get('project_name', 'project')}"
+                    )
+                    if github_result.get("success"):
+                        return f"✅ BOM saved to GitHub repository: {repo}"
+                    else:
+                        return f"❌ GitHub save failed: {github_result.get('message', 'Unknown error')}"
+                else:
+                    return "❌ GitHub repository name required."
+            
+            return f"✅ BOM exported successfully as {format_type}!"
+        else:
+            return f"❌ Export failed: {result.get('message', 'Unknown error')}"
+    
+    except Exception as e:
+        return f"❌ Export error: {str(e)}"
+
+def update_project_info(name: str, version: str, description: str) -> str:
+    """Update project information"""
+    try:
+        tinkeriq_app.session_state["project_info"].update({
+            "name": name or "Untitled Project",
+            "version": version or "1.0",
+            "description": description or ""
+        })
+        
+        # Update current BOM if it exists
+        if tinkeriq_app.session_state.get("current_bom"):
+            tinkeriq_app.session_state["current_bom"]["project_name"] = name or "Untitled Project"
+        
+        return f"✅ Project info updated: {name or 'Untitled Project'} v{version or '1.0'}"
+    
+    except Exception as e:
+        return f"❌ Error updating project info: {str(e)}"
+
+# Response formatting functions
+def format_analysis_response(analysis_data: Dict) -> str:
     """Format analysis response for display"""
     if not analysis_data.get("success"):
         return analysis_data.get("message", "Analysis failed")
@@ -167,10 +357,13 @@ def format_analysis_response(analysis_data):
 - Price: {comp['price']} | Supplier: {comp['supplier']}
 - Part #: {comp['part_number']}
 """
+        
+        response += f"""
+📋 **BOM Generated:** A bill of materials has been automatically created and is available in the BOM tab!"""
     
     return response
 
-def format_code_response(code_data):
+def format_code_response(code_data: Dict) -> str:
     """Format code generation response"""
     if not code_data.get("success"):
         return f"❌ **Code Generation Failed:** {code_data.get('message', 'Unknown error')}"
@@ -185,16 +378,19 @@ def format_code_response(code_data):
     response = f"""💻 **GENERATED {platform} CODE** - {circuit_type}:
 **Features:** {', '.join(features) if features else 'Basic functionality'}
 **Libraries:** {', '.join(libraries) if libraries else 'None required'}
+
 {code_block}
+
 **📋 Implementation Steps:**
 1. **Install Libraries:** {', '.join(libraries) if libraries else 'No additional libraries needed'}
 2. **Upload Code:** Copy to Arduino IDE and flash to {platform}
 3. **Check Wiring:** Verify connections match pin definitions
 4. **Test:** Confirm basic functionality
 """
+    
     return response
 
-def format_component_response(components_data):
+def format_component_response(components_data: Dict) -> str:
     """Format component recommendations"""
     if not components_data or not components_data.get("components"):
         return "No component recommendations available."
@@ -217,8 +413,10 @@ def format_component_response(components_data):
         response += f"*Found {len(components)} components from {total_suppliers} suppliers*"
     
     return response
-def chat_with_tinkeriq(message, history, image=None):
-    """Main chat function for TinkerIQ"""
+
+# Main chat function
+def chat_with_tinkeriq(message: str, history: List, image: Optional[str] = None) -> Tuple[List, str]:
+    """Main chat function for TinkerIQ with BOM integration"""
     print(f"💬 TinkerIQ Chat - Message: '{message}', Image: {bool(image)}")
     
     if not message.strip() and not image:
@@ -243,8 +441,10 @@ def chat_with_tinkeriq(message, history, image=None):
             formatted_analysis = format_analysis_response(analysis_data)
             response_parts.append(formatted_analysis)
         
-        # Handle code generation requests
+        # Handle different request types
         message_lower = message.lower()
+        
+        # Code generation requests
         if any(word in message_lower for word in ["code", "program", "generate", "firmware", "arduino", "esp32"]):
             print("🔧 Generating code...")
             
@@ -259,7 +459,7 @@ def chat_with_tinkeriq(message, history, image=None):
             formatted_code = format_code_response(code_data)
             response_parts.append(formatted_code)
         
-        # Handle component recommendations
+        # Component recommendations
         elif any(word in message_lower for word in ["component", "part", "buy", "need", "recommend", "shopping"]):
             print("🛒 Getting component recommendations...")
             
@@ -267,7 +467,26 @@ def chat_with_tinkeriq(message, history, image=None):
             formatted_components = format_component_response(components_data)
             response_parts.append(formatted_components)
         
-        # Handle reset requests
+        # BOM requests
+        elif any(word in message_lower for word in ["bom", "bill of materials", "export", "csv", "pdf"]):
+            current_bom = tinkeriq_app.session_state.get("current_bom")
+            if current_bom:
+                project_name = current_bom.get("project_name", "Unknown Project")
+                total_cost = current_bom.get("total_cost", "$0.00")
+                component_count = len(current_bom.get("components", []))
+                
+                response_parts.append(f"""📋 **BILL OF MATERIALS READY**
+• **Project:** {project_name}
+• **Components:** {component_count} items
+• **Total Cost:** {total_cost}
+
+✨ **Available in BOM Tab:** View, edit, and export your BOM in multiple formats (CSV, JSON, PDF)
+🚀 **Export Options:** Download, Email, or save to GitHub repository
+💡 **Pro Tip:** Use the BOM tab for detailed editing and professional export options!""")
+            else:
+                response_parts.append("📋 **No BOM Available:** Please analyze a circuit image first to generate a Bill of Materials.")
+        
+        # Reset requests
         elif "reset" in message_lower or "clear" in message_lower or "start over" in message_lower:
             reset_message = tinkeriq_app.reset_session()
             response_parts.append(reset_message)
@@ -276,598 +495,431 @@ def chat_with_tinkeriq(message, history, image=None):
         if not response_parts:
             if tinkeriq_app.session_state.get("last_analysis"):
                 response_parts.append("""💡 **What Would You Like To Do Next?**
-I see you've analyzed a circuit! Here's what I can help with:
-🔧 **Generate Code**: Say *"generate Arduino code"* or *"create ESP32 code with WiFi"*
-🛒 **Find Components**: Ask *"what components do I need?"* or *"show me parts list"*
-📋 **Get Guides**: Request *"wiring guide"* or *"library installation help"*
-**Quick Commands:**
-- *"Generate code"* - Create firmware for your circuit
-- *"Components"* - Get shopping list with prices
-- *"Help"* - Full command reference""")
+
+🔧 **Generate Code:** "Generate Arduino code for this circuit"
+🛒 **Find Components:** "Where can I buy these components?"
+📋 **View BOM:** "Show me the bill of materials"
+🚀 **Try Something:** "Add LED control with PWM"
+
+Or upload a new circuit image to analyze!""")
             else:
-                response_parts.append("""👋 **Welcome to TinkerIQ!**
-I'm your AI maker assistant. Here's how I can help:
-**🎯 Complete Maker Workflow:**
-1. **📷 Upload** a circuit image (schematic or breadboard)
-2. **🧠 AI Analysis** - I'll identify components and functionality  
-3. **💻 Code Generation** - Get custom Arduino/ESP32 firmware
-4. **🛒 Component Lists** - Find parts with real pricing
-**🚀 Try This:**
-Upload a circuit photo and say: *"Analyze this and generate code"*
-Ready to build something amazing? Upload your circuit! 🔧""")
-        
-        # Combine response parts
-        final_response = "\n\n".join(response_parts)
-        
-        # Add to conversation history
-        display_message = message if not image else f"{message} [📷 Image uploaded]"
-        history.append([display_message, final_response])
+                response_parts.append("""👋 **Welcome to TinkerIQ!** Your AI-powered maker assistant.
+
+🎯 **Get Started:**
+1. **📸 Upload a circuit image** to analyze components and functionality
+2. **💬 Ask questions** about electronics, programming, or components  
+3. **🔧 Generate code** for Arduino, ESP32, or Raspberry Pi
+4. **📋 Create BOMs** and export professional documentation
+
+**Example:** Upload a circuit photo and say "Analyze this LED matrix circuit" or "Generate Arduino code for this sensor setup"
+
+Ready to tinker? 🚀""")
         
-        return history, ""
+        # Combine all response parts
+        full_response = "\n\n".join(response_parts)
+        
+        # Add to history
+        history.append((message, full_response))
         
+        return history, ""
+    
     except Exception as e:
-        error_response = f"❌ **TinkerIQ Error:** {str(e)}\n\nPlease try again."
-        history.append([message or "[Image uploaded]", error_response])
+        print(f"❌ Chat error: {e}")
+        error_response = f"❌ **Error:** {str(e)}\n\nPlease try again or contact support if the issue persists."
+        history.append((message, error_response))
         return history, ""
 
-# Gradio Interface Creation - THIS MUST BE AT MODULE LEVEL, NOT INSIDE A FUNCTION
-with gr.Blocks(title="TinkerIQ - AI Maker Assistant", theme=gr.themes.Soft()) as app:
-    # Custom CSS for better styling
-    gr.HTML("""
-    <style>
-    /* Enhanced TinkerIQ Styling */
-    @import url('https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap');
-    
-    :root {
-        --primary-color: #667eea;
-        --secondary-color: #764ba2;
-        --accent-color: #4f46e5;
-        --success-color: #10b981;
-        --warning-color: #f59e0b;
-        --error-color: #ef4444;
-        --text-primary: #1f2937;
-        --text-secondary: #6b7280;
-        --bg-primary: #ffffff;
-        --bg-secondary: #f9fafb;
-        --border-color: #e5e7eb;
-    }
-    
-    /* Global Styles */
-    * {
-        font-family: 'Inter', -apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif;
-    }
-    
-    .gradio-container {
-        max-width: 1400px !important;
-        margin: 0 auto !important;
-        background: linear-gradient(135deg, #f0f4ff 0%, #e0e7ff 100%);
-        min-height: 100vh;
-    }
-    
-    /* Header Enhancements */
-    .tinkeriq-header {
-        text-align: center;
-        padding: 2rem;
-        background: linear-gradient(135deg, var(--primary-color) 0%, var(--secondary-color) 100%);
-        color: white;
-        border-radius: 16px;
-        margin-bottom: 2rem;
-        box-shadow: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 10px 10px -5px rgba(0, 0, 0, 0.04);
-        position: relative;
-        overflow: hidden;
-    }
-    
-    .tinkeriq-header::before {
-        content: '';
-        position: absolute;
-        top: 0;
-        left: 0;
-        right: 0;
-        bottom: 0;
-        background: linear-gradient(45deg, rgba(255,255,255,0.1) 0%, transparent 100%);
-        pointer-events: none;
-    }
-    
-    .tinkeriq-header h1 {
-        font-size: 2.5rem;
-        font-weight: 700;
-        margin-bottom: 0.5rem;
-        text-shadow: 0 2px 4px rgba(0,0,0,0.1);
-    }
-    
-    /* Chat Container */
-    .chat-container {
-        height: 600px !important;
-        border-radius: 16px !important;
-        border: 1px solid var(--border-color) !important;
-        box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1) !important;
-        background: var(--bg-primary) !important;
-    }
-    
-    /* Enhanced Cards */
-    .feature-card {
-        background: var(--bg-primary);
-        border: 1px solid var(--border-color);
-        border-radius: 12px;
-        padding: 1.5rem;
-        margin: 1rem 0;
-        transition: all 0.3s ease;
-        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
-        position: relative;
-        overflow: hidden;
-    }
-    
-    .feature-card::before {
-        content: '';
-        position: absolute;
-        top: 0;
-        left: 0;
-        width: 4px;
-        height: 100%;
-        background: linear-gradient(135deg, var(--primary-color), var(--secondary-color));
-    }
-    
-    .feature-card:hover {
-        transform: translateY(-2px);
-        box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05);
-        border-color: var(--accent-color);
-    }
-    
-    .feature-card h3 {
-        color: var(--text-primary);
-        font-weight: 600;
-        font-size: 1.25rem;
-        margin-bottom: 0.75rem;
-    }
-    
-    .feature-card p {
-        color: var(--text-secondary);
-        line-height: 1.6;
-    }
-    
-    /* Component Cards */
-    .component-card {
-        background: var(--bg-primary);
-        border: 1px solid var(--border-color);
-        border-radius: 12px;
-        padding: 1.25rem;
-        margin: 0.75rem 0;
-        transition: all 0.3s ease;
-        box-shadow: 0 2px 4px rgba(0, 0, 0, 0.05);
-    }
-    
-    .component-card:hover {
-        box-shadow: 0 8px 12px rgba(0, 0, 0, 0.1);
-        transform: translateY(-1px);
-    }
-    
-    .component-price {
-        background: linear-gradient(135deg, var(--success-color), #059669);
-        color: white;
-        padding: 0.25rem 0.75rem;
-        border-radius: 20px;
-        font-weight: 600;
-        font-size: 0.875rem;
-        display: inline-block;
-    }
-    
-    /* Status Indicators */
-    .status-indicator {
-        display: inline-block;
-        width: 12px;
-        height: 12px;
-        border-radius: 50%;
-        margin-right: 10px;
-        position: relative;
-        box-shadow: 0 0 0 3px rgba(40, 167, 69, 0.2);
-        animation: pulse 2s infinite;
-    }
-    
-    @keyframes pulse {
-        0% { box-shadow: 0 0 0 0 rgba(40, 167, 69, 0.7); }
-        70% { box-shadow: 0 0 0 10px rgba(40, 167, 69, 0); }
-        100% { box-shadow: 0 0 0 0 rgba(40, 167, 69, 0); }
-    }
-    
-    .status-active { 
-        background-color: var(--success-color);
-        box-shadow: 0 0 0 3px rgba(16, 185, 129, 0.2);
-    }
-    
-    .status-inactive { 
-        background-color: var(--error-color);
-        box-shadow: 0 0 0 3px rgba(239, 68, 68, 0.2);
-        animation: none;
-    }
-    
-    /* Enhanced Buttons */
-    .btn-primary {
-        background: linear-gradient(135deg, var(--primary-color), var(--accent-color));
-        color: white;
-        border: none;
-        border-radius: 8px;
-        padding: 0.75rem 1.5rem;
-        font-weight: 600;
-        transition: all 0.3s ease;
-        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
-    }
-    
-    .btn-primary:hover {
-        transform: translateY(-1px);
-        box-shadow: 0 10px 15px -3px rgba(0, 0, 0, 0.1);
-    }
-    
-    /* Code Blocks */
-    .code-block {
-        background: #1a1a1a;
-        border-radius: 12px;
-        padding: 1.5rem;
-        margin: 1rem 0;
-        border: 1px solid #374151;
-        position: relative;
-        overflow-x: auto;
-    }
-    
-    .code-block::before {
-        content: 'Code';
-        position: absolute;
-        top: 0.5rem;
-        right: 1rem;
-        background: var(--accent-color);
-        color: white;
-        padding: 0.25rem 0.75rem;
-        border-radius: 6px;
-        font-size: 0.75rem;
-        font-weight: 600;
-    }
-    
-    /* Input Enhancements */
-    .gradio-textbox, .gradio-file {
-        border-radius: 8px !important;
-        border: 2px solid var(--border-color) !important;
-        transition: all 0.3s ease !important;
-    }
-    
-    .gradio-textbox:focus, .gradio-file:focus-within {
-        border-color: var(--accent-color) !important;
-        box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.1) !important;
-    }
-    
-    /* Tab Enhancements */
-    .gradio-tabs {
-        border-radius: 12px;
-        overflow: hidden;
-        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
-    }
-    
-    .gradio-tab {
-        background: var(--bg-secondary);
-        border: 1px solid var(--border-color);
-        padding: 1rem 1.5rem;
-        font-weight: 500;
-        transition: all 0.3s ease;
-    }
-    
-    .gradio-tab.selected {
-        background: var(--bg-primary);
-        border-bottom-color: var(--accent-color);
-        color: var(--accent-color);
-    }
-    
-    /* Loading States */
-    .loading-spinner {
-        display: inline-block;
-        width: 20px;
-        height: 20px;
-        border: 3px solid rgba(79, 70, 229, 0.3);
-        border-radius: 50%;
-        border-top-color: var(--accent-color);
-        animation: spin 1s ease-in-out infinite;
-    }
+# System status functions
+def get_system_status() -> str:
+    """Get comprehensive system status"""
+    try:
+        # AI Provider Status
+        provider_status = []
+        for provider, available in tinkeriq_app.ai_providers.items():
+            status_class = "status-active" if available else "status-inactive"
+            status_text = "✅ Available" if available else "❌ Not Configured"
+            provider_status.append(f"• **{provider.title()}:** {status_text}")
+        
+        # Session Info
+        session = tinkeriq_app.session_state
+        analysis_status = "✅ Available" if session.get("last_analysis") else "❌ None"
+        components_status = "✅ Available" if session.get("last_components") else "❌ None"
+        code_status = "✅ Available" if session.get("last_code") else "❌ None"
+        bom_status = "✅ Available" if session.get("current_bom") else "❌ None"
+        
+        # BOM Statistics
+        current_bom = session.get("current_bom")
+        bom_stats = "No BOM available"
+        if current_bom:
+            component_count = len(current_bom.get("components", []))
+            total_cost = current_bom.get("total_cost", "$0.00")
+            project_name = current_bom.get("project_name", "Unknown")
+            bom_stats = f"**{project_name}** - {component_count} components, {total_cost}"
+        
+        project_info = session["project_info"]
+        
+        status_html = f"""
+**🔧 TinkerIQ System Status**
+
+**🤖 AI Providers:**
+{chr(10).join(provider_status)}
+
+**📊 Session Data:**
+• **Analysis:** {analysis_status}
+• **Components:** {components_status}
+• **Code:** {code_status}
+• **BOM:** {bom_status}
+• **Conversations:** {session['conversation_count']}
+
+**📋 Current BOM:**
+{bom_stats}
+
+**🔧 Project Info:**
+• **Name:** {project_info['name']}
+• **Version:** {project_info['version']}
+• **Created:** {project_info['created'][:10]}
+
+**🚀 Quick Setup Guide:**
+1. Configure AI Providers: Add API keys to your environment variables
+2. Upload Circuit Image: Start with the main chat interface
+3. Generate BOM: Components are automatically added after analysis
+4. Export & Share: Use the BOM tab for professional exports
+        """
+        
+        return status_html
     
-    @keyframes spin {
-        to { transform: rotate(360deg); }
-    }
+    except Exception as e:
+        return f"❌ Status Error: {str(e)}"
+
+def reset_session_ui() -> Tuple[str, str]:
+    """Reset session and return updated status"""
+    reset_message = tinkeriq_app.reset_session()
+    updated_status = get_system_status()
+    return reset_message, updated_status
+
+# Main Gradio Interface
+with gr.Blocks(title="TinkerIQ - AI Maker Assistant with BOM", theme=gr.themes.Soft()) as app:
     
-    /* Responsive Design */
-    @media (max-width: 768px) {
+    # Add CSS styling
+    gr.HTML("""
+    <style>
         .gradio-container {
-            padding: 1rem;
+            max-width: 1200px !important;
+            margin: 0 auto !important;
         }
-        
-        .tinkeriq-header {
-            padding: 1.5rem;
+        .chat-container {
+            height: 600px !important;
         }
-        
-        .tinkeriq-header h1 {
-            font-size: 2rem;
+        .header-style {
+            text-align: center;
+            padding: 20px;
+            background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
+            color: white;
+            border-radius: 10px;
+            margin-bottom: 20px;
+        }
+        .feature-grid {
+            display: grid;
+            grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
+            gap: 15px;
+            margin: 15px 0;
         }
-        
         .feature-card {
-            padding: 1rem;
+            background: #f8f9fa;
+            border: 1px solid #e9ecef;
+            border-radius: 8px;
+            padding: 15px;
         }
-    }
-    
-    /* Accessibility */
-    .sr-only {
-        position: absolute;
-        width: 1px;
-        height: 1px;
-        padding: 0;
-        margin: -1px;
-        overflow: hidden;
-        clip: rect(0, 0, 0, 0);
-        white-space: nowrap;
-        border: 0;
-    }
-    
-    /* Smooth Scrolling */
-    html {
-        scroll-behavior: smooth;
-    }
-    
-    /* Selection Styling */
-    ::selection {
-        background: rgba(79, 70, 229, 0.2);
-        color: var(--text-primary);
-    }
     </style>
     """)
     
     # Header
     gr.HTML("""
-    <div class="tinkeriq-header">
-        <h1>🧠 TinkerIQ - Your AI Maker Assistant</h1>
-        <p><strong>Complete Maker Workflow: Upload → Analyze → Code → Build!</strong></p>
-        <p>Advanced circuit analysis + Smart code generation + Real component recommendations</p>
+    <div class="header-style">
+        <h1>⚡ TinkerIQ with BOM Writer</h1>
+        <p><strong>AI-Powered Maker Assistant with Professional BOM Management</strong></p>
+        <div style="margin-top: 10px;">
+            <span style="margin: 0 10px;">🔍 Circuit Analysis</span>
+            <span style="margin: 0 10px;">💻 Code Generation</span>
+            <span style="margin: 0 10px;">🛒 Component Search</span>
+            <span style="margin: 0 10px;">📋 BOM Writer</span>
+        </div>
     </div>
     """)
     
-    with gr.Tab("💬 TinkerIQ Assistant"):
-        gr.Markdown("### 🚀 Complete AI-Powered Maker Workflow")
-        gr.Markdown("*Upload circuit images, get AI analysis, generate custom code, and find components!*")
-        
-        # Main chat interface
-        chatbot = gr.Chatbot(
-            height=600,
-            label="TinkerIQ - Smart Circuit Analysis & Code Generation",
-            show_label=True,
-            container=True,
-            bubble_full_width=False
-        )
-        
-        with gr.Row():
-            with gr.Column(scale=4):
-                msg = gr.Textbox(
-                    label="Your Message",
-                    placeholder="Upload circuit and ask: 'Analyze this and generate Arduino code with WiFi'",
-                    lines=2,
-                    max_lines=4
-                )
-            with gr.Column(scale=1):
-                send_btn = gr.Button("Send 🚀", variant="primary", size="lg")
-        
-        with gr.Row():
-            with gr.Column(scale=2):
-                image_upload = gr.File(
-                    file_types=["image"],
-                    label="📷 Upload Circuit Image",
-                    height=100
-                )
-            with gr.Column(scale=1):
-                clear_btn = gr.Button("Clear Chat 🗑️", variant="secondary")
-        
-        # Feature highlights
-        gr.HTML("""
-        <div class="feature-card">
-            <h4>🎯 TinkerIQ Capabilities:</h4>
-            <div style="display: grid; grid-template-columns: repeat(2, 1fr); gap: 15px; margin-top: 10px;">
-                <div>
-                    <strong>🔍 Vision Analysis:</strong><br>
-                    • Circuit component identification<br>
-                    • Schematic analysis & validation<br>
-                    • Troubleshooting assistance
+    with gr.Tabs() as tabs:
+        
+        # Main Chat Tab
+        with gr.Tab("💬 TinkerIQ Assistant"):
+            gr.Markdown("## 🚀 Complete AI-Powered Maker Workflow")
+            gr.Markdown("Upload circuit images, get AI analysis, generate code, find components, and create professional BOMs!")
+            
+            # Chat interface
+            chatbot = gr.Chatbot(
+                label="TinkerIQ - Smart Circuit Analysis & Code Generation with BOM",
+                height=600,
+                elem_classes=["chat-container"]
+            )
+            
+            with gr.Row():
+                with gr.Column(scale=4):
+                    msg = gr.Textbox(
+                        label="Your Message",
+                        placeholder="Describe your project, ask for help, or upload a circuit image...",
+                        lines=2
+                    )
+                with gr.Column(scale=1):
+                    send_btn = gr.Button("Send 🚀", variant="primary")
+            
+            with gr.Row():
+                with gr.Column(scale=2):
+                    file_upload = gr.File(
+                        label="📷 Upload Circuit Image",
+                        file_types=["image"],
+                        type="filepath"
+                    )
+                with gr.Column(scale=1):
+                    clear_btn = gr.Button("Clear Chat 🗑️")
+            
+            # Feature highlights
+            gr.HTML("""
+            <div class="feature-grid">
+                <div class="feature-card">
+                    <h4>🔍 Vision Analysis</h4>
+                    <p>Upload circuit images for AI-powered component identification and functionality analysis</p>
                 </div>
-                <div>
-                    <strong>💻 Code Generation:</strong><br>
-                    • Arduino & ESP32 firmware<br>
-                    • WiFi & web interface support<br>
-                    • Platform-specific optimization
+                <div class="feature-card">
+                    <h4>💻 Code Generation</h4>
+                    <p>Generate ready-to-use Arduino, ESP32, or Raspberry Pi code with proper libraries</p>
                 </div>
-                <div>
-                    <strong>🛒 Component Search:</strong><br>
-                    • Real-time pricing (Digi-Key, Adafruit)<br>
-                    • Smart recommendations<br>
-                    • Direct purchase links
+                <div class="feature-card">
+                    <h4>🛒 Component Search</h4>
+                    <p>Find real components with prices from Digi-Key, Adafruit, and SparkFun</p>
                 </div>
-                <div>
-                    <strong>📋 Complete Guides:</strong><br>
-                    • Wiring diagrams<br>
-                    • Library installation<br>
-                    • Step-by-step assembly
+                <div class="feature-card">
+                    <h4>📋 BOM Writer</h4>
+                    <p>Generate professional Bills of Materials with export to CSV, PDF, and GitHub</p>
                 </div>
             </div>
-        </div>
-        """)
-        
-        # Example commands
-        with gr.Accordion("💡 Example Commands", open=False):
-            gr.Markdown("""
-            **🌟 Try These Commands:**
-            
-            **Circuit Analysis:**
-            - *"Analyze this H-bridge circuit and suggest improvements"*
-            - *"What's wrong with my temperature sensor wiring?"*
-            - *"Explain how this circuit works for educational purposes"*
-            
-            **Code Generation:**
-            - *"Generate ESP32 code with WiFi for this motor controller"*
-            - *"Create Arduino code for temperature monitoring with alerts"*
-            - *"Add web interface control to this circuit"*
-            
-            **Component Shopping:**
-            - *"What components do I need for this project?"*
-            - *"Find cheaper alternatives for these parts"*
-            - *"Show me the complete shopping list"*
-            
-            **Project Guidance:**
-            - *"Give me the wiring guide for this setup"*
-            - *"What libraries do I need to install?"*
-            - *"Help me troubleshoot this circuit"*
             """)
-        
-        # Chat functionality
-        msg.submit(chat_with_tinkeriq, [msg, chatbot, image_upload], [chatbot, msg])
-        send_btn.click(chat_with_tinkeriq, [msg, chatbot, image_upload], [chatbot, msg])
-        clear_btn.click(lambda: [], outputs=[chatbot])
-    
-    with gr.Tab("⚙️ System Status"):
-        gr.Markdown("### 🔧 TinkerIQ System Status")
-        
-        def get_system_status():
-            """Get current system status"""
-            providers = tinkeriq_app.ai_providers
-            session = tinkeriq_app.session_state
-            
-            status_html = f"""
-            <div class="feature-card">
-                <h4>🤖 AI Provider Status:</h4>
-                <ul style="list-style: none; padding: 0;">
-                    <li><span class="status-indicator {'status-active' if providers['sambanova'] else 'status-inactive'}"></span>SambaNova AI {'✅ Available' if providers['sambanova'] else '❌ Not configured'}</li>
-                    <li><span class="status-indicator {'status-active' if providers['openai'] else 'status-inactive'}"></span>OpenAI {'✅ Available' if providers['openai'] else '❌ Not configured'}</li>
-                    <li><span class="status-indicator {'status-active' if providers['mistral'] else 'status-inactive'}"></span>Mistral AI {'✅ Available' if providers['mistral'] else '❌ Not configured'}</li>
-                    <li><span class="status-indicator {'status-active' if providers['anthropic'] else 'status-inactive'}"></span>Anthropic {'✅ Available' if providers['anthropic'] else '❌ Not configured'}</li>
-                    <li><span class="status-indicator {'status-active' if providers['huggingface'] else 'status-inactive'}"></span>Hugging Face {'✅ Available' if providers['huggingface'] else '❌ Not configured'}</li>
-                </ul>
-            </div>
             
-            <div class="feature-card">
-                <h4>📊 Session Information:</h4>
-                <ul>
-                    <li><strong>Conversations:</strong> {session['conversation_count']}</li>
-                    <li><strong>Has Analysis:</strong> {'✅ Yes' if session['last_analysis'] else '❌ No'}</li>
-                    <li><strong>Has Components:</strong> {'✅ Yes' if session['last_components'] else '❌ No'}</li>
-                    <li><strong>Has Generated Code:</strong> {'✅ Yes' if session['last_code'] else '❌ No'}</li>
-                    <li><strong>Active Providers:</strong> {sum(providers.values())}/{len(providers)}</li>
-                </ul>
-            </div>
+            # Example commands
+            with gr.Accordion("💡 Example Commands", open=False):
+                gr.Markdown("""
+                **🔍 Circuit Analysis:**
+                - "Analyze this LED matrix circuit"
+                - "What components do I need for this sensor setup?"
+                - "Troubleshoot this motor driver circuit"
+                
+                **💻 Code Generation:**
+                - "Generate Arduino code for this temperature sensor"
+                - "Create ESP32 code with WiFi for this IoT project"
+                - "Write Raspberry Pi Python code for this camera module"
+                
+                **🛒 Component Shopping:**
+                - "Where can I buy these components?"
+                - "Find cheaper alternatives for these parts"
+                - "Show me component specifications and datasheets"
+                
+                **📋 BOM Management:**
+                - "Create a bill of materials for this project"
+                - "Export BOM as PDF with cost analysis"
+                - "Save BOM to GitHub repository"
+                
+                **🚀 Project Guidance:**
+                - "How do I build a line-following robot?"
+                - "Design a home automation system with sensors"
+                - "Create a weather station with data logging"
+                """)
             
-            <div class="feature-card">
-                <h4>🔑 Setup Instructions:</h4>
-                <p>To enable missing AI providers, add these environment variables to your Space:</p>
-                <ul>
-                    <li><code>SAMBANOVA_API_KEY</code> - Your SambaNova API key</li>
-                    <li><code>OPENAI_API_KEY</code> - Your OpenAI API key</li>
-                    <li><code>MISTRAL_API_KEY</code> - Your Mistral API key</li>
-                    <li><code>ANTHROPIC_API_KEY</code> - Your Anthropic API key</li>
-                    <li><code>DIGIKEY_CLIENT_ID</code> - Digi-Key API client ID</li>
-                    <li><code>DIGIKEY_CLIENT_SECRET</code> - Digi-Key API secret</li>
-                </ul>
-            </div>
-            """
+            # Event handlers
+            msg.submit(chat_with_tinkeriq, [msg, chatbot, file_upload], [chatbot, msg])
+            send_btn.click(chat_with_tinkeriq, [msg, chatbot, file_upload], [chatbot, msg])
+            clear_btn.click(lambda: [], None, chatbot)
+        
+        # BOM Management Tab
+        with gr.Tab("📋 BOM Writer"):
+            gr.Markdown("## 🛠️ Professional Bill of Materials Management")
             
-            return status_html
-        
-        status_display = gr.HTML()
-        refresh_btn = gr.Button("🔄 Refresh Status", variant="secondary")
-        
-        # Load initial status
-        app.load(get_system_status, outputs=[status_display])
-        refresh_btn.click(get_system_status, outputs=[status_display])
-        
-        # Session management
-        gr.Markdown("### 🔄 Session Management")
-        
-        def reset_session_ui():
-            reset_msg = tinkeriq_app.reset_session()
-            return reset_msg, get_system_status()
-        
-        reset_session_btn = gr.Button("🗑️ Reset Session", variant="stop")
-        reset_output = gr.Textbox(label="Reset Status", interactive=False)
-        
-        reset_session_btn.click(
-            reset_session_ui, 
-            outputs=[reset_output, status_display]
-        )
-    
-    with gr.Tab("ℹ️ About TinkerIQ"):
-        gr.Markdown("""
-        ## 🧠 About TinkerIQ
-        
-        TinkerIQ is your complete AI-powered maker assistant that transforms how you approach electronics projects. From analyzing circuit images to generating custom code, TinkerIQ bridges the gap between ideas and working prototypes.
-        
-        ### 🎯 Core Features
-        
-        **🔍 Advanced Vision Analysis**
-        - Upload circuit schematics or breadboard photos
-        - AI identifies components, connections, and potential issues
-        - Multiple analysis modes: detailed, troubleshooting, educational
-        - Powered by SambaNova, OpenAI, and other leading AI providers
-        
-        **💻 Smart Code Generation**
-        - Custom Arduino and ESP32 firmware generation
-        - Platform-specific optimizations and features
-        - WiFi, web interface, and IoT connectivity support
-        - Intelligent feature detection from user requirements
-        
-        **🛒 Real Component Database**
-        - Live pricing and availability from Digi-Key, Adafruit, SparkFun
-        - Context-aware component recommendations
-        - Direct purchase links and supplier comparison
-        - Smart alternatives and compatibility checking
-        
-        **📋 Complete Project Guidance**
-        - Wiring diagrams and connection guides
-        - Library installation instructions
-        - Step-by-step assembly process
-        - Troubleshooting and debugging assistance
-        
-        ### 🚀 Workflow Example
-        
-        1. **📷 Upload** your circuit image
-        2. **🤖 AI Analysis** identifies an H-bridge motor controller
-        3. **💻 Code Generation** creates ESP32 firmware with WiFi control
-        4. **🛒 Component List** shows L298N driver, motors, and ESP32 board with real prices
-        5. **📋 Build Guide** provides wiring diagram and assembly instructions
-        
-        ### 🎓 Perfect For
-        
-        - **Students & Educators** - Interactive learning with real-world examples
-        - **Hobbyists** - Transform ideas into working prototypes quickly
-        - **Professionals** - Rapid prototyping and proof-of-concept development
-        - **Makers** - Complete project support from concept to completion
-        
-        ### 🔧 Supported Platforms
-        
-        - **Arduino** (Uno, Nano, Mega, ESP32, ESP8266)
-        - **Microcontrollers** (STM32, PIC, custom boards)
-        - **Single Board Computers** (Raspberry Pi, BeagleBone)
-        - **Custom PCBs** (KiCad, Eagle, Altium designs)
-        
-        ### 🌟 Advanced Capabilities
-        
-        - **Multi-Provider AI** - Automatic failover between AI services
-        - **Context Awareness** - Remembers your project across conversations
-        - **Smart Recommendations** - Learns from your preferences and project history
-        - **Real-Time Data** - Live component pricing and availability
-        - **Export Options** - Generate documentation, BOMs, and project files
-        
-        ---
-        
-        **🚀 Ready to revolutionize your maker projects?**
+            with gr.Row():
+                with gr.Column(scale=2):
+                    # Project Info
+                    gr.Markdown("### 📝 Project Information")
+                    with gr.Row():
+                        project_name = gr.Textbox(label="Project Name", value="Untitled Project")
+                        project_version = gr.Textbox(label="Version", value="1.0")
+                    project_description = gr.Textbox(label="Description", lines=2)
+                    update_project_btn = gr.Button("Update Project Info 📝")
+                    project_status = gr.Textbox(label="Status", interactive=False)
+                
+                with gr.Column(scale=1):
+                    # BOM Summary
+                    gr.Markdown("### 📊 BOM Summary")
+                    bom_summary = gr.Markdown("No BOM available. Please analyze a circuit first.")
+                    refresh_bom_btn = gr.Button("Refresh BOM 🔄")
+            
+            # BOM Data Table
+            gr.Markdown("### 📋 Components List")
+            bom_dataframe = gr.Dataframe(
+                headers=["Item", "Qty", "Part Number", "Description", 
+                        "Manufacturer", "Supplier", "Unit Price", "Total Price"],
+                label="Bill of Materials",
+                interactive=True,
+                wrap=True
+            )
+            
+            # Export Options
+            gr.Markdown("### 📤 Export Options")
+            with gr.Row():
+                with gr.Column():
+                    gr.Markdown("**📁 Format**")
+                    export_format = gr.Radio(["CSV", "JSON", "PDF"], value="CSV", label="Export Format")
+                
+                with gr.Column():
+                    gr.Markdown("**🚀 Method**")
+                    export_method = gr.Radio(["Download", "Email", "GitHub"], value="Download", label="Export Method")
+            
+            # Conditional inputs based on export method
+            with gr.Row():
+                email_input = gr.Textbox(label="📧 Email Address", placeholder="[email protected]", visible=False)
+                github_input = gr.Textbox(label="🐙 GitHub Repository", placeholder="username/repository-name", visible=False)
+            
+            export_btn = gr.Button("Export BOM 📤", variant="primary")
+            export_status = gr.Textbox(label="Export Status", interactive=False)
+            
+            # Export method visibility controls
+            def update_export_inputs(method):
+                return (
+                    gr.update(visible=method=="Email"),
+                    gr.update(visible=method=="GitHub")
+                )
+            
+            export_method.change(update_export_inputs, export_method, [email_input, github_input])
+            
+            # BOM event handlers
+            def refresh_bom_display():
+                df, summary = get_current_bom_data()
+                return df, summary
+            
+            def export_bom_handler(format_type, method, email, github):
+                if method == "Email":
+                    return export_bom(format_type, method, email=email)
+                elif method == "GitHub":
+                    return export_bom(format_type, method, github_repo=github)
+                else:
+                    return export_bom(format_type, method)
+            
+            refresh_bom_btn.click(refresh_bom_display, None, [bom_dataframe, bom_summary])
+            update_project_btn.click(update_project_info, [project_name, project_version, project_description], project_status)
+            export_btn.click(export_bom_handler, [export_format, export_method, email_input, github_input], export_status)
         
-        Upload a circuit image and let TinkerIQ guide you from analysis to assembly!
+        # System Status Tab
+        with gr.Tab("⚙️ System Status"):
+            gr.Markdown("## 🔧 TinkerIQ System Status")
+            
+            status_display = gr.Markdown(get_system_status())
+            refresh_btn = gr.Button("🔄 Refresh Status")
+            
+            # Session Management
+            gr.Markdown("## 🔄 Session Management")
+            with gr.Row():
+                reset_session_btn = gr.Button("🗑️ Reset Session", variant="stop")
+                reset_status = gr.Textbox(label="Reset Status", interactive=False)
+            
+            # Event handlers
+            refresh_btn.click(get_system_status, None, status_display)
+            reset_session_btn.click(reset_session_ui, None, [reset_status, status_display])
         
-        *Built with ❤️ for the global maker community using cutting-edge AI technology.*
-        """)
+        # About Tab
+        with gr.Tab("ℹ️ About TinkerIQ"):
+            gr.Markdown("""
+            # ⚡ TinkerIQ with BOM Writer
+            
+            ## 🎯 Purpose & Mission
+            TinkerIQ is your complete AI-powered maker assistant designed to streamline the entire electronics project workflow - from initial circuit analysis to professional documentation and procurement.
+            
+            ## 🚀 Core Features
+            
+            ### 🔍 **Advanced Circuit Analysis**
+            - **AI Vision Processing** using SambaNova Llama 3 Vision and OpenAI GPT-4o
+            - **Component Identification** with real-time database matching
+            - **Functionality Analysis** with detailed technical explanations
+            - **Troubleshooting Guidance** for debugging and optimization
+            
+            ### 💻 **Smart Code Generation**
+            - **Multi-Platform Support**: Arduino, ESP32, Raspberry Pi
+            - **Intelligent Libraries**: Auto-detection and inclusion
+            - **Pin Configuration**: Automatic pin assignment and mapping
+            - **Feature-Rich Code**: PWM, sensors, communications, IoT integration
+            
+            ### 🛒 **Real Component Search**
+            - **Live Supplier Integration**: Digi-Key API, Adafruit, SparkFun
+            - **Price Comparison**: Real-time pricing across multiple suppliers
+            - **Stock Availability**: Current inventory status
+            - **Alternative Suggestions**: Cost-effective equivalent components
+            
+            ### 📋 **Professional BOM Writer** *(NEW!)*
+            - **Automatic Generation**: BOMs created from circuit analysis
+            - **Multi-Format Export**: CSV, JSON, PDF with professional formatting
+            - **Cost Analysis**: Total project cost with supplier breakdown
+            - **Storage Integration**: GitHub, Email, Cloud storage options
+            - **Project Management**: Version control and history tracking
+            - **Procurement Ready**: Direct supplier links and part numbers
+            
+            ## 🎮 Example Workflow
+            
+            1. **📸 Upload** a circuit schematic or breadboard photo
+            2. **🔍 AI Analysis** identifies components and functionality
+            3. **📋 BOM Generation** creates professional bill of materials
+            4. **💻 Code Creation** generates platform-specific firmware
+            5. **🛒 Component Sourcing** finds real parts with current pricing
+            6. **📤 Export & Share** professional documentation for procurement
+            
+            ## 👥 Who It's For
+            
+            - **🔧 Makers & Hobbyists**: Streamline project development
+            - **🎓 Students & Educators**: Learn electronics with AI guidance
+            - **⚡ Engineers**: Rapid prototyping and documentation
+            - **🏢 Startups**: Professional BOMs and cost analysis
+            - **🎯 Researchers**: Quick circuit analysis and replication
+            
+            ## 🛠️ Supported Platforms
+            
+            ### **Microcontrollers**
+            - Arduino (Uno, Nano, Mega, etc.)
+            - ESP32 / ESP8266 (WiFi/Bluetooth)
+            - Raspberry Pi (Python)
+            - STM32 and other ARM boards
+            
+            ### **Components**
+            - Sensors (Temperature, Motion, Light, etc.)
+            - Actuators (Motors, Servos, LEDs)
+            - Communication (I2C, SPI, UART, WiFi)
+            - Power Management (Regulators, Batteries)
+            
+            ## 🔮 Advanced Capabilities
+            
+            - **Multi-AI Provider Fallback** for maximum reliability
+            - **Real-time Component Pricing** with market updates
+            - **Professional PDF Reports** with company branding
+            - **GitHub Integration** for version-controlled documentation
+            - **Cost Optimization** with alternative component suggestions
+            - **Educational Mode** with detailed explanations
+            - **Troubleshooting Mode** for debugging assistance
+            
+            ## 🚀 Get Started
+            
+            Ready to revolutionize your electronics workflow? Start by uploading a circuit image in the main chat tab, or explore the BOM Writer to see professional documentation in action!
+            
+            **Built with ❤️ for the maker community**
+            """)
 
-# Launch configuration - NOW THIS IS AT MODULE LEVEL WHERE 'app' IS DEFINED
+# Launch the application
 if __name__ == "__main__":
+    print("🚀 Launching TinkerIQ with BOM Writer...")
     app.launch(
         server_name="0.0.0.0",
         server_port=7860,
-        share=False,
-        debug=False,
-        show_error=True,
-        quiet=False
+        share=True,
+        show_error=True
     )