Add Windows installer packaging (v1.1.0)

Package the app as a distributable Windows installer using PyInstaller
and Inno Setup. Refactored app.py to expose create_app() for reuse by
the new desktop_app.py entry point. Installer prompts for OpenRouter
API key during setup and creates Start Menu/desktop shortcuts.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

.gitignore

@@ -3,3 +3,13 @@ __pycache__/
 *.pyc
 .env
 CLAUDE.md
+
+# Build artifacts
+build/
+dist/
+Output/
+*.spec
+
+# Source reference documents (local only)
+*.pdf
+Suno Database.txt

CHANGELOG.md

@@ -1,5 +1,27 @@
 # Changelog
 
+## [1.1.0] - 2026-02-18
+
+### Added
+- **Windows installer packaging** via PyInstaller + Inno Setup
+  - `desktop_app.py` — Packaged entry point that launches Gradio in default browser with no console window
+  - `build.bat` — One-click build script that runs PyInstaller and optionally Inno Setup
+  - `installer.iss` — Inno Setup script with custom API key prompt during installation
+  - `hooks/hook-gradio.py` — PyInstaller hook for Gradio source collection
+  - `runtime_hook.py` — Multiprocessing freeze support for PyInstaller
+- Installer features:
+  - Professional setup wizard with custom API key input page
+  - Start Menu and optional desktop shortcuts
+  - Add/Remove Programs entry
+  - Writes `.env` file with API key to install directory
+  - Option to launch app after installation
+- Build produces both a portable exe (`dist/SunoPromptGenerator/`) and an installer (`Output/SunoPromptGenerator_Setup.exe`)
+
+### Changed
+- Refactored `app.py` to expose `create_app()` function, allowing reuse by both dev mode and desktop packaging
+- Updated `.gitignore` to exclude build artifacts (`build/`, `dist/`, `Output/`, `*.spec`) and source reference documents
+- Removed `pywebview` from requirements (pythonnet incompatible with Python 3.14; using browser-based approach instead)
+
 ## [1.0.1] - 2025-02-18
 
 ### Changed

app.py

@@ -16,10 +16,6 @@ from knowledge_base import build_system_prompt
 # CONFIG
 # ─────────────────────────────────────────────
 
-load_dotenv()
-
-OPENROUTER_API_KEY = os.getenv("OPENROUTER_API_KEY", "")
-
 MODELS = {
     "Google Gemini 3 Pro": "google/gemini-3-pro-preview",
     "Google Gemini 3 Flash": "google/gemini-3-flash-preview",
@@ -29,9 +25,34 @@ MODELS = {
     "Custom": "custom",
 }
 
-client = OpenAI(
-    base_url="https://openrouter.ai/api/v1",
-    api_key=OPENROUTER_API_KEY,
+THEME = gr.themes.Base(
+    primary_hue=gr.themes.colors.orange,
+    secondary_hue=gr.themes.colors.neutral,
+    neutral_hue=gr.themes.colors.gray,
+    font=gr.themes.GoogleFont("Inter"),
+).set(
+    body_background_fill="#1a1a1a",
+    body_background_fill_dark="#1a1a1a",
+    body_text_color="#e0e0e0",
+    body_text_color_dark="#e0e0e0",
+    block_background_fill="#2a2a2a",
+    block_background_fill_dark="#2a2a2a",
+    block_border_color="#444",
+    block_border_color_dark="#444",
+    block_label_text_color="#ccc",
+    block_label_text_color_dark="#ccc",
+    block_title_text_color="#fff",
+    block_title_text_color_dark="#fff",
+    input_background_fill="#333",
+    input_background_fill_dark="#333",
+    input_border_color="#555",
+    input_border_color_dark="#555",
+    button_primary_background_fill="#e67e22",
+    button_primary_background_fill_dark="#e67e22",
+    button_primary_background_fill_hover="#d35400",
+    button_primary_background_fill_hover_dark="#d35400",
+    button_primary_text_color="#fff",
+    button_primary_text_color_dark="#fff",
 )
 
 
@@ -39,6 +60,14 @@ client = OpenAI(
 # CORE LOGIC
 # ─────────────────────────────────────────────
 
+def _get_client():
+    """Create OpenAI client using current env var."""
+    return OpenAI(
+        base_url="https://openrouter.ai/api/v1",
+        api_key=os.getenv("OPENROUTER_API_KEY", ""),
+    )
+
+
 def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdness: int):
     """Call OpenRouter and parse the structured response."""
     if not song_idea.strip():
@@ -53,6 +82,7 @@ def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdn
         model_id = MODELS.get(model_choice, "google/gemini-3-flash-preview")
 
     system_prompt = build_system_prompt(weirdness)
+    client = _get_client()
 
     try:
         response = client.chat.completions.create(
@@ -70,7 +100,6 @@ def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdn
         # Strip markdown code fences if present
         if raw.startswith("```"):
             lines = raw.split("\n")
-            # Remove first line (```json or ```) and last line (```)
             if lines[-1].strip() == "```":
                 lines = lines[1:-1]
             else:
@@ -83,7 +112,6 @@ def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdn
         style_prompt = data.get("style_prompt", "")
         lyrics = data.get("lyrics", "")
 
-        # Build settings display
         w = data.get("weirdness", "N/A")
         w_reason = data.get("weirdness_reasoning", "")
         si = data.get("style_influence", "N/A")
@@ -95,7 +123,6 @@ def generate_prompt(song_idea: str, model_choice: str, custom_model: str, weirdn
         return song_title, style_prompt, lyrics, settings, cover_art
 
     except json.JSONDecodeError:
-        # If JSON parsing fails, show raw response
         return (
             "",
             f"[JSON parse error - raw response below]\n\n{raw}",
@@ -113,132 +140,113 @@ def toggle_custom_visibility(choice):
 
 
 # ─────────────────────────────────────────────
-# UI
+# APP BUILDER
 # ─────────────────────────────────────────────
 
-theme = gr.themes.Base(
-    primary_hue=gr.themes.colors.orange,
-    secondary_hue=gr.themes.colors.neutral,
-    neutral_hue=gr.themes.colors.gray,
-    font=gr.themes.GoogleFont("Inter"),
-).set(
-    body_background_fill="#1a1a1a",
-    body_background_fill_dark="#1a1a1a",
-    body_text_color="#e0e0e0",
-    body_text_color_dark="#e0e0e0",
-    block_background_fill="#2a2a2a",
-    block_background_fill_dark="#2a2a2a",
-    block_border_color="#444",
-    block_border_color_dark="#444",
-    block_label_text_color="#ccc",
-    block_label_text_color_dark="#ccc",
-    block_title_text_color="#fff",
-    block_title_text_color_dark="#fff",
-    input_background_fill="#333",
-    input_background_fill_dark="#333",
-    input_border_color="#555",
-    input_border_color_dark="#555",
-    button_primary_background_fill="#e67e22",
-    button_primary_background_fill_dark="#e67e22",
-    button_primary_background_fill_hover="#d35400",
-    button_primary_background_fill_hover_dark="#d35400",
-    button_primary_text_color="#fff",
-    button_primary_text_color_dark="#fff",
-)
-
-with gr.Blocks(title="Suno Prompt Generator") as app:
-    gr.Markdown("# Suno Prompt Generator\nDescribe your song idea in natural language. Get back structured Suno prompts.")
-
-    with gr.Row():
-        model_dropdown = gr.Dropdown(
-            choices=list(MODELS.keys()),
-            value="Google Gemini 3 Flash",
-            label="AI Model",
-            scale=2,
+def create_app():
+    """Build and return the Gradio Blocks app and theme."""
+    with gr.Blocks(title="Suno Prompt Generator") as demo:
+        gr.Markdown("# Suno Prompt Generator\nDescribe your song idea in natural language. Get back structured Suno prompts.")
+
+        with gr.Row():
+            model_dropdown = gr.Dropdown(
+                choices=list(MODELS.keys()),
+                value="Google Gemini 3 Flash",
+                label="AI Model",
+                scale=2,
+            )
+            custom_model_input = gr.Textbox(
+                label="Custom Model ID",
+                placeholder="e.g. meta-llama/llama-4-maverick",
+                visible=False,
+                scale=2,
+            )
+
+        song_input = gr.Textbox(
+            label="Song Idea",
+            placeholder="A melancholy song about driving alone at night on empty highways, with a female vocal that sounds tired but hopeful...",
+            lines=4,
         )
-        custom_model_input = gr.Textbox(
-            label="Custom Model ID",
-            placeholder="e.g. meta-llama/llama-4-maverick",
-            visible=False,
-            scale=2,
+
+        weirdness_slider = gr.Slider(
+            minimum=0,
+            maximum=100,
+            value=30,
+            step=1,
+            label="Weirdness (0 = conventional, 100 = maximum creative hallucination)",
         )
 
-    song_input = gr.Textbox(
-        label="Song Idea",
-        placeholder="A melancholy song about driving alone at night on empty highways, with a female vocal that sounds tired but hopeful...",
-        lines=4,
-    )
+        generate_btn = gr.Button("Generate Suno Prompt", variant="primary", size="lg")
 
-    weirdness_slider = gr.Slider(
-        minimum=0,
-        maximum=100,
-        value=30,
-        step=1,
-        label="Weirdness (0 = conventional, 100 = maximum creative hallucination)",
-    )
+        gr.Markdown("---")
 
-    generate_btn = gr.Button("Generate Suno Prompt", variant="primary", size="lg")
+        style_output = gr.Textbox(
+            label="Style Prompt (paste into Suno's Style Prompt field)",
+            lines=5,
+            buttons=["copy"],
+            interactive=False,
+        )
 
-    gr.Markdown("---")
+        title_output = gr.Textbox(
+            label="Song Title",
+            lines=1,
+            buttons=["copy"],
+            interactive=False,
+        )
 
-    style_output = gr.Textbox(
-        label="Style Prompt (paste into Suno's Style Prompt field)",
-        lines=5,
-        buttons=["copy"],
-        interactive=False,
-    )
+        lyrics_output = gr.Textbox(
+            label="Lyrics with Tags (paste into Suno's Lyrics field)",
+            lines=20,
+            buttons=["copy"],
+            interactive=False,
+        )
 
-    title_output = gr.Textbox(
-        label="Song Title",
-        lines=1,
-        buttons=["copy"],
-        interactive=False,
-    )
+        with gr.Row():
+            settings_output = gr.Textbox(
+                label="Suno UI Settings",
+                lines=5,
+                interactive=False,
+                scale=1,
+            )
 
-    lyrics_output = gr.Textbox(
-        label="Lyrics with Tags (paste into Suno's Lyrics field)",
-        lines=20,
-        buttons=["copy"],
-        interactive=False,
-    )
+        gr.Markdown("---")
 
-    with gr.Row():
-        settings_output = gr.Textbox(
-            label="Suno UI Settings",
-            lines=5,
+        cover_art_output = gr.Textbox(
+            label="Cover Art Image Prompt (paste into Grok or image generator)",
+            lines=6,
+            buttons=["copy"],
             interactive=False,
-            scale=1,
         )
 
-    gr.Markdown("---")
+        # Events
+        model_dropdown.change(
+            fn=toggle_custom_visibility,
+            inputs=model_dropdown,
+            outputs=custom_model_input,
+        )
 
-    cover_art_output = gr.Textbox(
-        label="Cover Art Image Prompt (paste into Grok or image generator)",
-        lines=6,
-        buttons=["copy"],
-        interactive=False,
-    )
+        outputs = [title_output, style_output, lyrics_output, settings_output, cover_art_output]
 
-    # Events
-    model_dropdown.change(
-        fn=toggle_custom_visibility,
-        inputs=model_dropdown,
-        outputs=custom_model_input,
-    )
+        generate_btn.click(
+            fn=generate_prompt,
+            inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
+            outputs=outputs,
+        )
+
+        song_input.submit(
+            fn=generate_prompt,
+            inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
+            outputs=outputs,
+        )
 
-    outputs = [title_output, style_output, lyrics_output, settings_output, cover_art_output]
+    return demo, THEME
 
-    generate_btn.click(
-        fn=generate_prompt,
-        inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
-        outputs=outputs,
-    )
 
-    song_input.submit(
-        fn=generate_prompt,
-        inputs=[song_input, model_dropdown, custom_model_input, weirdness_slider],
-        outputs=outputs,
-    )
+# ─────────────────────────────────────────────
+# DEV MODE ENTRY POINT
+# ─────────────────────────────────────────────
 
 if __name__ == "__main__":
-    app.launch(inbrowser=True, theme=theme)
+    load_dotenv()
+    demo, theme = create_app()
+    demo.launch(inbrowser=True, theme=theme)

build.bat

@@ -0,0 +1,122 @@
+@echo off
+setlocal
+
+echo ============================================================
+echo   Suno Prompt Generator - Build Script
+echo ============================================================
+echo.
+
+:: Set project directory to wherever this script lives
+cd /d "%~dp0"
+
+:: ─────────────────────────────────────────────
+:: STEP 1: Check prerequisites
+:: ─────────────────────────────────────────────
+echo [1/4] Checking prerequisites...
+
+:: Check Python venv
+if not exist "venv\Scripts\python.exe" (
+    echo ERROR: Python venv not found. Run: python -m venv venv
+    echo        Then: venv\Scripts\pip install -r requirements.txt pyinstaller
+    pause
+    exit /b 1
+)
+
+:: Check PyInstaller
+venv\Scripts\python.exe -c "import PyInstaller" 2>nul
+if errorlevel 1 (
+    echo ERROR: PyInstaller not installed. Run: venv\Scripts\pip install pyinstaller
+    pause
+    exit /b 1
+)
+
+echo    Python venv: OK
+echo    PyInstaller: OK
+
+:: Check for Inno Setup (optional — only needed for installer)
+set "ISCC="
+where iscc.exe >nul 2>&1 && set "ISCC=iscc.exe"
+if "%ISCC%"=="" (
+    if exist "C:\Program Files (x86)\Inno Setup 6\ISCC.exe" set "ISCC=C:\Program Files (x86)\Inno Setup 6\ISCC.exe"
+)
+if "%ISCC%"=="" (
+    if exist "C:\Program Files\Inno Setup 6\ISCC.exe" set "ISCC=C:\Program Files\Inno Setup 6\ISCC.exe"
+)
+if "%ISCC%"=="" (
+    echo    Inno Setup: NOT FOUND - will skip installer creation
+    echo    Download from: https://jrsoftware.org/isdl.php
+) else (
+    echo    Inno Setup: OK
+)
+echo.
+
+:: ─────────────────────────────────────────────
+:: STEP 2: Clean previous build
+:: ─────────────────────────────────────────────
+echo [2/4] Cleaning previous build artifacts...
+if exist "dist" rmdir /s /q "dist"
+if exist "build" rmdir /s /q "build"
+if exist "SunoPromptGenerator.spec" del /q "SunoPromptGenerator.spec"
+echo    Done.
+echo.
+
+:: ─────────────────────────────────────────────
+:: STEP 3: Run PyInstaller
+:: ─────────────────────────────────────────────
+echo [3/4] Running PyInstaller...
+echo    This may take a few minutes...
+echo.
+
+venv\Scripts\pyinstaller.exe ^
+    --noconfirm ^
+    --windowed ^
+    --name "SunoPromptGenerator" ^
+    --additional-hooks-dir hooks ^
+    --runtime-hook runtime_hook.py ^
+    --collect-data gradio ^
+    --collect-data gradio_client ^
+    --add-data "knowledge_base.py;." ^
+    desktop_app.py
+
+if errorlevel 1 (
+    echo.
+    echo ERROR: PyInstaller build failed!
+    pause
+    exit /b 1
+)
+
+echo.
+echo    PyInstaller build complete: dist\SunoPromptGenerator\
+echo.
+
+:: ─────────────────────────────────────────────
+:: STEP 4: Run Inno Setup (if available)
+:: ─────────────────────────────────────────────
+if "%ISCC%"=="" (
+    echo [4/4] Skipping installer creation (Inno Setup not found).
+    echo    You can still run the app directly from: dist\SunoPromptGenerator\SunoPromptGenerator.exe
+    echo    To create an installer, install Inno Setup 6 and re-run this script.
+) else (
+    echo [4/4] Creating Windows installer with Inno Setup...
+    "%ISCC%" installer.iss
+    if errorlevel 1 (
+        echo.
+        echo ERROR: Inno Setup build failed!
+        pause
+        exit /b 1
+    )
+    echo.
+    echo    Installer created: Output\SunoPromptGenerator_Setup.exe
+)
+
+echo.
+echo ============================================================
+echo   BUILD COMPLETE!
+echo ============================================================
+echo.
+if not "%ISCC%"=="" (
+    echo   Installer: Output\SunoPromptGenerator_Setup.exe
+)
+echo   Portable:  dist\SunoPromptGenerator\SunoPromptGenerator.exe
+echo.
+pause

desktop_app.py

@@ -0,0 +1,44 @@
+"""
+Desktop entry point for packaged Suno Prompt Generator.
+Launches Gradio and opens it in the default browser.
+Runs without a visible console window (PyInstaller --windowed).
+"""
+
+import multiprocessing
+import os
+import signal
+import sys
+import webbrowser
+
+
+def main():
+    # Determine the install/exe directory for .env loading
+    if getattr(sys, "frozen", False):
+        # Running as a PyInstaller bundle
+        app_dir = os.path.dirname(sys.executable)
+    else:
+        # Running as a script (dev mode)
+        app_dir = os.path.dirname(os.path.abspath(__file__))
+
+    # Load .env from the install directory
+    env_path = os.path.join(app_dir, ".env")
+    from dotenv import load_dotenv
+    load_dotenv(env_path)
+
+    # Import and build the Gradio app
+    from app import create_app
+    demo, theme = create_app()
+
+    # Launch Gradio — opens in default browser, blocks until closed
+    demo.launch(
+        server_name="127.0.0.1",
+        server_port=0,  # Random free port
+        share=False,
+        inbrowser=True,
+        theme=theme,
+    )
+
+
+if __name__ == "__main__":
+    multiprocessing.freeze_support()
+    main()

hooks/hook-gradio.py

@@ -0,0 +1,7 @@
+# PyInstaller hook for Gradio.
+# Gradio reads its own .py source files at runtime for component metadata,
+# so we must collect them as source rather than compiled bytecode.
+
+module_collection_mode = {
+    "gradio": "py",
+}

installer.iss

@@ -0,0 +1,67 @@
+; Inno Setup Script for Suno Prompt Generator
+
+[Setup]
+AppName=Suno Prompt Generator
+AppVersion=1.1.0
+AppPublisher=AnimalMonk
+AppPublisherURL=https://github.com/AnimalMonk/Suno-Prompting-App
+DefaultDirName={autopf}\SunoPromptGenerator
+DefaultGroupName=Suno Prompt Generator
+OutputBaseFilename=SunoPromptGenerator_Setup
+OutputDir=Output
+Compression=lzma2
+SolidCompression=yes
+WizardStyle=modern
+PrivilegesRequired=lowest
+DisableProgramGroupPage=yes
+
+[Files]
+Source: "dist\SunoPromptGenerator\*"; DestDir: "{app}"; Flags: ignoreversion recursesubdirs createallsubdirs
+
+[Icons]
+Name: "{group}\Suno Prompt Generator"; Filename: "{app}\SunoPromptGenerator.exe"
+Name: "{autodesktop}\Suno Prompt Generator"; Filename: "{app}\SunoPromptGenerator.exe"; Tasks: desktopicon
+
+[Tasks]
+Name: "desktopicon"; Description: "Create a desktop shortcut"; GroupDescription: "Additional shortcuts:"
+
+[Run]
+Filename: "{app}\SunoPromptGenerator.exe"; Description: "Launch Suno Prompt Generator"; Flags: nowait postinstall skipifsilent
+
+[Code]
+var
+  ApiKeyPage: TInputQueryWizardPage;
+
+procedure InitializeWizard();
+begin
+  ApiKeyPage := CreateInputQueryPage(wpSelectDir,
+    'API Configuration',
+    'Enter your OpenRouter API key to use the application.',
+    'You need an OpenRouter API key. Get one at https://openrouter.ai/keys'#13#10 +
+    'This will be saved locally in the install directory.');
+  ApiKeyPage.Add('OpenRouter API Key:', False);
+end;
+
+function NextButtonClick(CurPageID: Integer): Boolean;
+begin
+  Result := True;
+  if CurPageID = ApiKeyPage.ID then
+  begin
+    if Trim(ApiKeyPage.Values[0]) = '' then
+    begin
+      MsgBox('Please enter your OpenRouter API key to continue.', mbError, MB_OK);
+      Result := False;
+    end;
+  end;
+end;
+
+procedure CurStepChanged(CurStep: TSetupStep);
+var
+  EnvContent: String;
+begin
+  if CurStep = ssPostInstall then
+  begin
+    EnvContent := 'OPENROUTER_API_KEY=' + Trim(ApiKeyPage.Values[0]);
+    SaveStringToFile(ExpandConstant('{app}\.env'), EnvContent, False);
+  end;
+end;

requirements.txt

@@ -1,3 +1,6 @@
 gradio
 openai
 python-dotenv
+
+# Build-time only (not needed at runtime):
+# pip install pyinstaller

runtime_hook.py

@@ -0,0 +1,3 @@
+# PyInstaller runtime hook for multiprocessing freeze support.
+import multiprocessing
+multiprocessing.freeze_support()