aimodelshare 0.1.29__py3-none-any.whl → 0.1.64__py3-none-any.whl

aimodelshare/moral_compass/apps/ai_consequences.py

@@ -0,0 +1,297 @@
+"""
+AI Consequences - Gradio application for the Justice & Equity Challenge.
+
+This app teaches:
+1. The consequences of wrong AI predictions in criminal justice
+2. Understanding false positives and false negatives
+3. The ethical stakes of relying on AI for high-stakes decisions
+
+Structure:
+- Factory function `create_ai_consequences_app()` returns a Gradio Blocks object
+- Convenience wrapper `launch_ai_consequences_app()` launches it inline (for notebooks)
+"""
+import contextlib
+import os
+
+
+def create_ai_consequences_app(theme_primary_hue: str = "indigo") -> "gr.Blocks":
+    """Create the AI Consequences Gradio Blocks app (not launched yet)."""
+    try:
+        import gradio as gr
+    except ImportError as e:
+        raise ImportError(
+            "Gradio is required for the AI consequences app. Install with `pip install gradio`."
+        ) from e
+    
+    css = """
+    .large-text {
+        font-size: 20px !important;
+    }
+    .warning-box {
+        background: #fef2f2 !important;
+        border-left: 6px solid #dc2626 !important;
+    }
+    """
+    
+    with gr.Blocks(theme=gr.themes.Soft(primary_hue=theme_primary_hue), css=css) as demo:
+        gr.Markdown("<h1 style='text-align:center;'>⚠️ What If the AI Was Wrong?</h1>")
+        gr.Markdown(
+            """
+            <div style='text-align:center; font-size:18px; max-width: 900px; margin: auto;
+                        padding: 20px; background-color: #fef2f2; border-radius: 12px; border: 2px solid #dc2626;'>
+            You just made decisions based on an AI's predictions.<br>
+            But AI systems are not perfect. Let's explore what happens when they make mistakes.
+            </div>
+            """
+        )
+        gr.HTML("<hr style='margin:24px 0;'>")
+        
+        # Step 1: Introduction
+        with gr.Column(visible=True) as step_1:
+            gr.Markdown("<h2 style='text-align:center;'>The Stakes of AI Predictions</h2>")
+            gr.Markdown(
+                """
+                <div style='font-size: 20px; background:#dbeafe; padding:28px; border-radius:16px;'>
+                <p>In the previous exercise, you relied on an AI system to predict which defendants 
+                were at <b>High</b>, <b>Medium</b>, or <b>Low</b> risk of re-offending.</p>
+                
+                <p style='margin-top:20px;'><b>But what if those predictions were incorrect?</b></p>
+                
+                <p style='margin-top:20px;'>AI systems make two types of errors that have very different consequences:</p>
+                
+                <ul style='font-size:18px; margin-top:12px;'>
+                    <li><b>False Positives</b> - Incorrectly predicting HIGH risk</li>
+                    <li><b>False Negatives</b> - Incorrectly predicting LOW risk</li>
+                </ul>
+                
+                <p style='margin-top:20px;'>Let's examine each type of error and its real-world impact.</p>
+                </div>
+                """
+            )
+            step_1_next = gr.Button("Next: False Positives ▶️", variant="primary", size="lg")
+        
+        # Step 2: False Positives
+        with gr.Column(visible=False) as step_2:
+            gr.Markdown("<h2 style='text-align:center;'>🔴 False Positives: Predicting Danger Where None Exists</h2>")
+            gr.Markdown(
+                """
+                <div style='font-size: 20px; background:#fef3c7; padding:28px; border-radius:16px; border: 3px solid #f59e0b;'>
+                <h3 style='color:#b45309; margin-top:0;'>What is a False Positive?</h3>
+                
+                <p>A <b>false positive</b> occurs when the AI predicts someone is <b style='color:#dc2626;'>HIGH RISK</b>, 
+                but they would NOT have actually re-offended if released.</p>
+                
+                <div style='background:white; padding:20px; border-radius:8px; margin:20px 0;'>
+                    <h4 style='margin-top:0;'>Example Scenario:</h4>
+                    <p style='font-size:18px;'>
+                    • Sarah was flagged as <b style='color:#dc2626;'>HIGH RISK</b><br>
+                    • Based on this, the judge kept her in prison<br>
+                    • In reality, Sarah would have rebuilt her life and never committed another crime
+                    </p>
+                </div>
+                
+                <h3 style='color:#b45309;'>The Human Cost:</h3>
+                <ul style='font-size:18px;'>
+                    <li>Innocent people spend unnecessary time in prison</li>
+                    <li>Families are separated for longer than needed</li>
+                    <li>Job opportunities and rehabilitation are delayed</li>
+                    <li>Trust in the justice system erodes</li>
+                    <li>Disproportionate impact on marginalized communities</li>
+                </ul>
+                
+                <div style='background:#fef2f2; padding:16px; border-radius:8px; margin-top:20px; border-left:6px solid #dc2626;'>
+                    <p style='font-size:18px; margin:0;'><b>Key Point:</b> False positives mean the AI is being 
+                    <b>too cautious</b>, keeping people locked up who should be free.</p>
+                </div>
+                </div>
+                """
+            )
+            with gr.Row():
+                step_2_back = gr.Button("◀️ Back", size="lg")
+                step_2_next = gr.Button("Next: False Negatives ▶️", variant="primary", size="lg")
+        
+        # Step 3: False Negatives
+        with gr.Column(visible=False) as step_3:
+            gr.Markdown("<h2 style='text-align:center;'>🔵 False Negatives: Missing Real Danger</h2>")
+            gr.Markdown(
+                """
+                <div style='font-size: 20px; background:#f0fdf4; padding:28px; border-radius:16px; border: 3px solid #16a34a;'>
+                <h3 style='color:#15803d; margin-top:0;'>What is a False Negative?</h3>
+                
+                <p>A <b>false negative</b> occurs when the AI predicts someone is <b style='color:#16a34a;'>LOW RISK</b>, 
+                but they DO actually re-offend after being released.</p>
+                
+                <div style='background:white; padding:20px; border-radius:8px; margin:20px 0;'>
+                    <h4 style='margin-top:0;'>Example Scenario:</h4>
+                    <p style='font-size:18px;'>
+                    • James was flagged as <b style='color:#16a34a;'>LOW RISK</b><br>
+                    • Based on this, the judge released him<br>
+                    • Unfortunately, James did commit another serious crime
+                    </p>
+                </div>
+                
+                <h3 style='color:#15803d;'>The Human Cost:</h3>
+                <ul style='font-size:18px;'>
+                    <li>New victims of preventable crimes</li>
+                    <li>Loss of public trust in the justice system</li>
+                    <li>Media scrutiny and backlash against judges</li>
+                    <li>Political pressure to be "tough on crime"</li>
+                    <li>Potential harm to communities and families</li>
+                </ul>
+                
+                <div style='background:#fef2f2; padding:16px; border-radius:8px; margin-top:20px; border-left:6px solid #dc2626;'>
+                    <p style='font-size:18px; margin:0;'><b>Key Point:</b> False negatives mean the AI is being 
+                    <b>too lenient</b>, releasing people who pose a real danger to society.</p>
+                </div>
+                </div>
+                """
+            )
+            with gr.Row():
+                step_3_back = gr.Button("◀️ Back", size="lg")
+                step_3_next = gr.Button("Next: The Dilemma ▶️", variant="primary", size="lg")
+        
+        # Step 4: The Dilemma
+        with gr.Column(visible=False) as step_4:
+            gr.Markdown("<h2 style='text-align:center;'>⚖️ The Impossible Balance</h2>")
+            gr.Markdown(
+                """
+                <div style='font-size: 20px; background:#faf5ff; padding:28px; border-radius:16px; border: 3px solid #9333ea;'>
+                <h3 style='color:#7e22ce; margin-top:0;'>Every AI System Makes Trade-offs</h3>
+                
+                <p>Here's the harsh reality: <b>No AI system can eliminate both types of errors.</b></p>
+                
+                <div style='background:white; padding:24px; border-radius:12px; margin:24px 0;'>
+                    <p style='font-size:18px; margin-bottom:16px;'><b>If you make the AI more cautious:</b></p>
+                    <ul style='font-size:18px;'>
+                        <li>✓ Fewer false negatives (fewer dangerous people released)</li>
+                        <li>✗ More false positives (more innocent people kept in prison)</li>
+                    </ul>
+                    
+                    <hr style='margin:20px 0;'>
+                    
+                    <p style='font-size:18px; margin-bottom:16px;'><b>If you make the AI more lenient:</b></p>
+                    <ul style='font-size:18px;'>
+                        <li>✓ Fewer false positives (more innocent people freed)</li>
+                        <li>✗ More false negatives (more dangerous people released)</li>
+                    </ul>
+                </div>
+                
+                <h3 style='color:#7e22ce;'>The Ethical Question:</h3>
+                <div style='background:#fef2f2; padding:20px; border-radius:8px; border-left:6px solid #dc2626;'>
+                    <p style='font-size:20px; font-weight:bold; margin:0;'>
+                    Which mistake is worse?
+                    </p>
+                    <p style='font-size:18px; margin-top:12px; margin-bottom:0;'>
+                    • Keeping innocent people in prison?<br>
+                    • Or releasing dangerous individuals?
+                    </p>
+                </div>
+                
+                <p style='margin-top:24px; font-size:18px;'><b>There is no universally "correct" answer.</b> 
+                Different societies, legal systems, and ethical frameworks weigh these trade-offs differently.</p>
+                
+                <div style='background:#dbeafe; padding:16px; border-radius:8px; margin-top:20px;'>
+                    <p style='font-size:18px; margin:0;'><b>This is why understanding AI is crucial.</b> 
+                    We need to know how these systems work so we can make informed decisions about when 
+                    and how to use them.</p>
+                </div>
+                </div>
+                """
+            )
+            with gr.Row():
+                step_4_back = gr.Button("◀️ Back", size="lg")
+                step_4_next = gr.Button("Continue to Learn About AI ▶️", variant="primary", size="lg")
+        
+        # Step 5: Completion
+        with gr.Column(visible=False) as step_5:
+            gr.Markdown(
+                """
+                <div style='text-align:center;'>
+                    <h2 style='font-size: 2.5rem;'>✅ Section Complete!</h2>
+                    <div style='font-size: 1.3rem; background:#e0f2fe; padding:28px; border-radius:16px;
+                                border: 2px solid #0284c7;'>
+                        <p>You now understand the consequences of AI errors in high-stakes decisions.</p>
+                        
+                        <p style='margin-top:24px;'><b>Next up:</b> Learn what AI actually is and how these 
+                        prediction systems work.</p>
+                        
+                        <p style='margin-top:24px;'>This knowledge will help you understand how to build 
+                        better, more ethical AI systems.</p>
+                        
+                        <h1 style='margin:20px 0; font-size: 3rem;'>👇 SCROLL DOWN 👇</h1>
+                        <p style='font-size:1.1rem;'>Find the next section below to continue your journey.</p>
+                    </div>
+                </div>
+                """
+            )
+            back_to_dilemma_btn = gr.Button("◀️ Back to Review")
+        
+        # Navigation logic
+        step_1_next.click(
+            lambda: (gr.update(visible=False), gr.update(visible=True), gr.update(visible=False), 
+                    gr.update(visible=False), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_2_back.click(
+            lambda: (gr.update(visible=True), gr.update(visible=False), gr.update(visible=False), 
+                    gr.update(visible=False), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_2_next.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=True), 
+                    gr.update(visible=False), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_3_back.click(
+            lambda: (gr.update(visible=False), gr.update(visible=True), gr.update(visible=False), 
+                    gr.update(visible=False), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_3_next.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), 
+                    gr.update(visible=True), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_4_back.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=True), 
+                    gr.update(visible=False), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        step_4_next.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), 
+                    gr.update(visible=False), gr.update(visible=True)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+        
+        back_to_dilemma_btn.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=False), 
+                    gr.update(visible=True), gr.update(visible=False)),
+            inputs=None,
+            outputs=[step_1, step_2, step_3, step_4, step_5]
+        )
+    
+    return demo
+
+
+def launch_ai_consequences_app(height: int = 1000, share: bool = False, debug: bool = False) -> None:
+    """Convenience wrapper to create and launch the AI consequences app inline."""
+    demo = create_ai_consequences_app()
+    try:
+        import gradio as gr  # noqa: F401
+    except ImportError as e:
+        raise ImportError("Gradio must be installed to launch the AI consequences app.") from e
+    with contextlib.redirect_stdout(open(os.devnull, 'w')), contextlib.redirect_stderr(open(os.devnull, 'w')):
+        demo.launch(share=share, inline=True, debug=debug, height=height)

aimodelshare/moral_compass/apps/judge.py

@@ -0,0 +1,299 @@
+"""
+You Be the Judge - Gradio application for the Justice & Equity Challenge.
+
+This app teaches:
+1. How to make decisions based on AI predictions
+2. The stakes involved in using AI for criminal justice decisions
+3. The importance of understanding what AI gets wrong
+
+Structure:
+- Factory function `create_judge_app()` returns a Gradio Blocks object
+- Convenience wrapper `launch_judge_app()` launches it inline (for notebooks)
+"""
+import contextlib
+import os
+
+
+def _generate_defendant_profiles():
+    """Generate synthetic defendant profiles for the exercise."""
+    import random
+    random.seed(42)  # For reproducibility
+    
+    profiles = [
+        {
+            "id": 1,
+            "name": "Carlos M.",
+            "age": 23,
+            "gender": "Male",
+            "race": "Hispanic",
+            "prior_offenses": 2,
+            "current_charge": "Drug possession",
+            "ai_risk": "High",
+            "ai_confidence": "85%"
+        },
+        {
+            "id": 2,
+            "name": "Sarah J.",
+            "age": 34,
+            "gender": "Female",
+            "race": "White",
+            "prior_offenses": 0,
+            "current_charge": "Theft",
+            "ai_risk": "Low",
+            "ai_confidence": "72%"
+        },
+        {
+            "id": 3,
+            "name": "DeShawn W.",
+            "age": 19,
+            "gender": "Male",
+            "race": "Black",
+            "prior_offenses": 1,
+            "current_charge": "Assault",
+            "ai_risk": "Medium",
+            "ai_confidence": "68%"
+        },
+        {
+            "id": 4,
+            "name": "Maria R.",
+            "age": 41,
+            "gender": "Female",
+            "race": "Hispanic",
+            "prior_offenses": 3,
+            "current_charge": "Fraud",
+            "ai_risk": "Medium",
+            "ai_confidence": "70%"
+        },
+        {
+            "id": 5,
+            "name": "James K.",
+            "age": 28,
+            "gender": "Male",
+            "race": "White",
+            "prior_offenses": 5,
+            "current_charge": "Burglary",
+            "ai_risk": "High",
+            "ai_confidence": "91%"
+        }
+    ]
+    
+    return profiles
+
+
+def create_judge_app(theme_primary_hue: str = "indigo") -> "gr.Blocks":
+    """Create the You Be the Judge Gradio Blocks app (not launched yet)."""
+    try:
+        import gradio as gr
+    except ImportError as e:
+        raise ImportError(
+            "Gradio is required for the judge app. Install with `pip install gradio`."
+        ) from e
+    
+    profiles = _generate_defendant_profiles()
+    
+    # State to track decisions
+    decisions = {}
+    
+    def format_profile(profile):
+        """Format a defendant profile for display."""
+        risk_color = {
+            "High": "#ef4444",
+            "Medium": "#f59e0b", 
+            "Low": "#22c55e"
+        }
+        
+        color = risk_color.get(profile["ai_risk"], "#6b7280")
+        
+        return f"""
+        <div style='background:#f9fafb; padding:20px; border-radius:12px; border-left: 6px solid {color};'>
+            <h3 style='margin-top:0; color:#1f2937;'>Defendant #{profile['id']}: {profile['name']}</h3>
+            <div style='display: grid; grid-template-columns: 1fr 1fr; gap: 12px; font-size: 16px;'>
+                <div><b>Age:</b> {profile['age']}</div>
+                <div><b>Gender:</b> {profile['gender']}</div>
+                <div><b>Race:</b> {profile['race']}</div>
+                <div><b>Prior Offenses:</b> {profile['prior_offenses']}</div>
+                <div style='grid-column: span 2;'><b>Current Charge:</b> {profile['current_charge']}</div>
+            </div>
+            <div style='margin-top:16px; padding:12px; background:white; border-radius:8px;'>
+                <b>🤖 AI Risk Assessment:</b> 
+                <span style='color:{color}; font-size:20px; font-weight:bold;'>{profile['ai_risk']} Risk</span>
+                <span style='color:#6b7280; margin-left:8px;'>(Confidence: {profile['ai_confidence']})</span>
+            </div>
+        </div>
+        """
+    
+    def make_decision(defendant_id, decision):
+        """Record a decision for a defendant."""
+        decisions[defendant_id] = decision
+        return f"✓ Decision recorded: {decision}"
+    
+    def get_summary():
+        """Get summary of all decisions made."""
+        if not decisions:
+            return "No decisions made yet."
+        
+        released = sum(1 for d in decisions.values() if d == "Release")
+        kept = sum(1 for d in decisions.values() if d == "Keep in Prison")
+        
+        summary = f"""
+        <div style='background:#dbeafe; padding:20px; border-radius:12px;'>
+            <h3 style='margin-top:0;'>📊 Your Decisions Summary</h3>
+            <div style='font-size:18px;'>
+                <p><b>Prisoners Released:</b> {released} of {len(decisions)}</p>
+                <p><b>Prisoners Kept in Prison:</b> {kept} of {len(decisions)}</p>
+            </div>
+        </div>
+        """
+        return summary
+    
+    css = """
+    .decision-button {
+        font-size: 18px !important;
+        padding: 12px 24px !important;
+    }
+    """
+    
+    with gr.Blocks(theme=gr.themes.Soft(primary_hue=theme_primary_hue), css=css) as demo:
+        gr.Markdown("<h1 style='text-align:center;'>⚖️ You Be the Judge</h1>")
+        gr.Markdown(
+            """
+            <div style='text-align:center; font-size:18px; max-width: 900px; margin: auto;
+                        padding: 20px; background-color: #fef3c7; border-radius: 12px; border: 2px solid #f59e0b;'>
+            <b>Your Role:</b> You are a judge who must decide whether to release defendants from prison.<br>
+            An AI system has analyzed each case and provided a risk assessment.<br><br>
+            <b>Your Task:</b> Review each defendant's profile and the AI's prediction, then make your decision.
+            </div>
+            """
+        )
+        gr.HTML("<hr style='margin:24px 0;'>")
+        
+        # Introduction
+        with gr.Column(visible=True) as intro_section:
+            gr.Markdown("<h2 style='text-align:center;'>📋 The Scenario</h2>")
+            gr.Markdown(
+                """
+                <div style='font-size: 18px; background:#e0f2fe; padding:24px; border-radius:12px;'>
+                You are a judge in a busy criminal court. Due to prison overcrowding, you must decide 
+                which defendants can be safely released.<br><br>
+                
+                To help you, the court has implemented an AI system that predicts the risk of each 
+                defendant committing new crimes if released. The AI categorizes defendants as:<br><br>
+                
+                <ul style='font-size:18px;'>
+                    <li><span style='color:#ef4444; font-weight:bold;'>High Risk</span> - Likely to re-offend</li>
+                    <li><span style='color:#f59e0b; font-weight:bold;'>Medium Risk</span> - Moderate chance of re-offending</li>
+                    <li><span style='color:#22c55e; font-weight:bold;'>Low Risk</span> - Unlikely to re-offend</li>
+                </ul>
+                
+                <b>Remember:</b> Your decisions affect real people's lives and public safety.
+                </div>
+                """
+            )
+            start_btn = gr.Button("Begin Making Decisions ▶️", variant="primary", size="lg")
+        
+        # Defendant profiles section
+        with gr.Column(visible=False) as profiles_section:
+            gr.Markdown("<h2 style='text-align:center;'>👥 Defendant Profiles</h2>")
+            gr.Markdown(
+                """
+                <div style='text-align:center; font-size:16px; background:#f3f4f6; padding:12px; border-radius:8px;'>
+                Review each defendant's information and the AI's risk assessment, then make your decision.
+                </div>
+                """
+            )
+            gr.HTML("<br>")
+            
+            # Create UI for each defendant
+            for profile in profiles:
+                with gr.Column():
+                    gr.HTML(format_profile(profile))
+                    
+                    with gr.Row():
+                        release_btn = gr.Button(
+                            "✓ Release Prisoner", 
+                            variant="primary",
+                            elem_classes=["decision-button"]
+                        )
+                        keep_btn = gr.Button(
+                            "✗ Keep in Prison",
+                            variant="secondary",
+                            elem_classes=["decision-button"]
+                        )
+                    
+                    decision_status = gr.Markdown("")
+                    
+                    # Wire up buttons
+                    release_btn.click(
+                        lambda p_id=profile["id"]: make_decision(p_id, "Release"),
+                        inputs=None,
+                        outputs=decision_status
+                    )
+                    keep_btn.click(
+                        lambda p_id=profile["id"]: make_decision(p_id, "Keep in Prison"),
+                        inputs=None,
+                        outputs=decision_status
+                    )
+                    
+                    gr.HTML("<hr style='margin:24px 0;'>")
+            
+            # Summary section
+            summary_display = gr.HTML("")
+            show_summary_btn = gr.Button("📊 Show My Decisions Summary", variant="primary", size="lg")
+            show_summary_btn.click(get_summary, inputs=None, outputs=summary_display)
+            
+            gr.HTML("<br>")
+            complete_btn = gr.Button("Complete This Section ▶️", variant="primary", size="lg")
+        
+        # Completion section
+        with gr.Column(visible=False) as complete_section:
+            gr.Markdown(
+                """
+                <div style='text-align:center;'>
+                    <h2 style='font-size: 2.5rem;'>✅ Decisions Complete!</h2>
+                    <div style='font-size: 1.3rem; background:#e0f2fe; padding:28px; border-radius:16px;
+                                border: 2px solid #0284c7;'>
+                        You've made your decisions based on the AI's recommendations.<br><br>
+                        But here's the critical question:<br><br>
+                        <h2 style='color:#dc2626; margin:16px 0;'>What if the AI was wrong?</h2>
+                        <p style='font-size:1.1rem;'>
+                        Continue to the next section below to explore the consequences of 
+                        trusting AI predictions in high-stakes situations.
+                        </p>
+                        <h1 style='margin:20px 0; font-size: 3rem;'>👇 SCROLL DOWN 👇</h1>
+                    </div>
+                </div>
+                """
+            )
+            back_to_profiles_btn = gr.Button("◀️ Back to Review Decisions")
+        
+        # Navigation logic
+        start_btn.click(
+            lambda: (gr.update(visible=False), gr.update(visible=True), gr.update(visible=False)),
+            inputs=None,
+            outputs=[intro_section, profiles_section, complete_section]
+        )
+        
+        complete_btn.click(
+            lambda: (gr.update(visible=False), gr.update(visible=False), gr.update(visible=True)),
+            inputs=None,
+            outputs=[intro_section, profiles_section, complete_section]
+        )
+        
+        back_to_profiles_btn.click(
+            lambda: (gr.update(visible=False), gr.update(visible=True), gr.update(visible=False)),
+            inputs=None,
+            outputs=[intro_section, profiles_section, complete_section]
+        )
+    
+    return demo
+
+
+def launch_judge_app(height: int = 1200, share: bool = False, debug: bool = False) -> None:
+    """Convenience wrapper to create and launch the judge app inline."""
+    demo = create_judge_app()
+    try:
+        import gradio as gr  # noqa: F401
+    except ImportError as e:
+        raise ImportError("Gradio must be installed to launch the judge app.") from e
+    with contextlib.redirect_stdout(open(os.devnull, 'w')), contextlib.redirect_stderr(open(os.devnull, 'w')):
+        demo.launch(share=share, inline=True, debug=debug, height=height)