CLI(V1): Add ASCII art splash screen to PyInstaller executable

openhands-cli/build.py

@@ -13,17 +13,22 @@
 import sys
 from pathlib import Path
 from openhands_cli.locations import PERSISTENCE_DIR, WORK_DIR, AGENT_SETTINGS_PATH
-from openhands.sdk.preset.default import get_default_agent
-from openhands.sdk import LLM
 import time
 import select
 
-dummy_agent = get_default_agent(
-    llm=LLM(model='dummy-model', api_key='dummy-key'),
-    working_dir=WORK_DIR,
-    persistence_dir=PERSISTENCE_DIR,
-    cli_mode=True
-)
+# Try to import SDK components for testing, but don't fail if not available
+dummy_agent = None
+try:
+    from openhands.sdk.preset.default import get_default_agent
+    from openhands.sdk import LLM
+    dummy_agent = get_default_agent(
+        llm=LLM(model='dummy-model', api_key='dummy-key'),
+        working_dir=WORK_DIR,
+        persistence_dir=PERSISTENCE_DIR,
+        cli_mode=True
+    )
+except ImportError:
+    print("⚠️  SDK not available during build - testing will be limited")
 
 # =================================================
 # SECTION: Build Binary
@@ -129,10 +134,12 @@ def test_executable() -> bool:
     specs_path = Path(os.path.expanduser(spec_path))
     if specs_path.exists():
         print(f"⚠️  Using existing settings at {specs_path}")
-    else:
+    elif dummy_agent is not None:
         print(f"💾 Creating dummy settings at {specs_path}")
         specs_path.parent.mkdir(parents=True, exist_ok=True)
         specs_path.write_text(dummy_agent.model_dump_json())
+    else:
+        print("⚠️  Cannot create dummy settings - SDK not available")
 
     exe_path = Path('dist/openhands-cli')
     if not exe_path.exists():

openhands-cli/create_splash.py

@@ -0,0 +1,105 @@
+#!/usr/bin/env python3
+"""
+Create an ASCII art splash screen image for OpenHands CLI PyInstaller executable.
+"""
+
+from PIL import Image, ImageDraw, ImageFont
+import os
+
+def create_splash_screen():
+    """Create an ASCII art splash screen image for the OpenHands CLI."""
+
+    # Image dimensions
+    width, height = 800, 500
+
+    # Colors (dark theme)
+    bg_color = (20, 20, 20)  # Very dark gray
+    text_color = (0, 255, 0)  # Green (classic terminal color)
+    accent_color = (0, 200, 255)  # Cyan
+
+    # Create image
+    img = Image.new('RGB', (width, height), bg_color)
+    draw = ImageDraw.Draw(img)
+
+    # Try to use a monospace font for ASCII art
+    try:
+        ascii_font = ImageFont.truetype("/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf", 12)
+        title_font = ImageFont.truetype("/usr/share/fonts/truetype/dejavu/DejaVuSansMono-Bold.ttf", 16)
+        loading_font = ImageFont.truetype("/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf", 14)
+    except OSError:
+        # Fallback to default font
+        ascii_font = ImageFont.load_default()
+        title_font = ImageFont.load_default()
+        loading_font = ImageFont.load_default()
+
+    # ASCII art for OpenHands logo/title
+    ascii_art = [
+        "   ___                   _   _                 _      ",
+        "  / _ \\ _ __   ___ _ __ | | | | __ _ _ __   __| |___  ",
+        " | | | | '_ \\ / _ \\ '_ \\| |_| |/ _` | '_ \\ / _` / __| ",
+        " | |_| | |_) |  __/ | | |  _  | (_| | | | | (_| \\__ \\ ",
+        "  \\___/| .__/ \\___|_| |_|_| |_|\\__,_|_| |_|\\__,_|___/ ",
+        "       |_|                                           ",
+        "",
+        "                      _____ _     _____ ",
+        "                     /  ___| |   |_   _|",
+        "                     \\ `--.| |     | |  ",
+        "                      `--. \\ |     | |  ",
+        "                     /\\__/ / |_____| |_ ",
+        "                     \\____/\\_____/\\___/ ",
+    ]
+
+    # Calculate starting position for ASCII art
+    line_height = 20
+    total_height = len(ascii_art) * line_height
+    start_y = (height - total_height) // 2 - 50
+
+    # Draw ASCII art
+    for i, line in enumerate(ascii_art):
+        # Center each line
+        line_bbox = draw.textbbox((0, 0), line, font=ascii_font)
+        line_width = line_bbox[2] - line_bbox[0]
+        line_x = (width - line_width) // 2
+        line_y = start_y + i * line_height
+
+        # Use accent color for the main logo, text color for CLI
+        color = accent_color if i < 6 else text_color
+        draw.text((line_x, line_y), line, fill=color, font=ascii_font)
+
+    # Draw subtitle
+    subtitle_text = "AI-Powered Software Development Assistant"
+    subtitle_bbox = draw.textbbox((0, 0), subtitle_text, font=loading_font)
+    subtitle_width = subtitle_bbox[2] - subtitle_bbox[0]
+    subtitle_x = (width - subtitle_width) // 2
+    subtitle_y = start_y + len(ascii_art) * line_height + 30
+    draw.text((subtitle_x, subtitle_y), subtitle_text, fill=text_color, font=loading_font)
+
+    # Draw loading indicator with ASCII style
+    loading_text = ">>> Initializing..."
+    loading_bbox = draw.textbbox((0, 0), loading_text, font=loading_font)
+    loading_width = loading_bbox[2] - loading_bbox[0]
+    loading_x = (width - loading_width) // 2
+    loading_y = height - 60
+    draw.text((loading_x, loading_y), loading_text, fill=accent_color, font=loading_font)
+
+    # Draw ASCII progress bar
+    progress_bar = "[" + "=" * 20 + ">" + " " * 10 + "]"
+    progress_bbox = draw.textbbox((0, 0), progress_bar, font=ascii_font)
+    progress_width = progress_bbox[2] - progress_bbox[0]
+    progress_x = (width - progress_width) // 2
+    progress_y = loading_y + 25
+    draw.text((progress_x, progress_y), progress_bar, fill=text_color, font=ascii_font)
+
+    # Draw terminal-style border
+    border_chars = "+" + "-" * ((width // 8) - 2) + "+"
+    draw.text((10, 10), border_chars, fill=accent_color, font=ascii_font)
+    draw.text((10, height - 30), border_chars, fill=accent_color, font=ascii_font)
+
+    # Save the image
+    img.save('splash.png', 'PNG')
+    print("✅ ASCII art splash screen created: splash.png")
+
+    return 'splash.png'
+
+if __name__ == "__main__":
+    create_splash_screen()

openhands-cli/openhands-cli.spec

@@ -14,6 +14,7 @@ from PyInstaller.utils.hooks import (
     collect_data_files,
     copy_metadata
 )
+from PyInstaller.building.splash import Splash
 
 
 
@@ -87,9 +88,23 @@ a = Analysis(
 )
 pyz = PYZ(a.pure)
 
+# Create splash screen
+splash = Splash(
+    'splash.png',
+    binaries=a.binaries,
+    datas=a.datas,
+    text_pos=(10, 350),  # Position for loading text
+    text_size=12,
+    text_color='white',
+    minify_script=True,
+    always_on_top=True,
+)
+
 exe = EXE(
     pyz,
     a.scripts,
+    splash,  # Include splash screen
+    splash.binaries,  # Include splash binaries
     a.binaries,
     a.datas,
     [],

openhands-cli/openhands_cli/simple_main.py

@@ -26,6 +26,22 @@ def main() -> None:
     """
 
     try:
+        # Close splash screen if running as PyInstaller executable
+        try:
+            import pyi_splash
+            # Update splash screen text before closing
+            pyi_splash.update_text("Initializing OpenHands CLI...")
+            # Give a moment for the splash to be visible
+            import time
+            time.sleep(1)
+            pyi_splash.close()
+        except ImportError:
+            # Not running as PyInstaller executable, splash screen not available
+            pass
+        except Exception as e:
+            # Handle any splash screen errors gracefully
+            print(f"Splash screen error: {e}")
+
         # Start agent chat directly by default
         run_cli_entry()