feat: add description to the app

src/app_description.py

@@ -0,0 +1,36 @@
+import gradio as gr
+
+def app_description():
+    gr.Markdown("""
+        # 🎮 LLMGameHub - Your Personal Visual Novel
+        
+        **Craft your own adventures with an AI-powered game master!**
+        
+        🎥 [Video Demo](https://youtu.be/pQfP9lA1QUM)
+        
+        This application is an interactive storytelling experience where you are the author. Create a unique world, design your character, and let our AI agent weave a narrative tailored to your choices. It's a blend of a game constructor and a visual novel, powered by generative AI.
+        
+        ## 🎯 Key Features
+        - **🤖 AI Game Master**: An intelligent agent that generates a dynamic story with branching narratives based on your inputs.
+        - **🎨 World Building**: Define your own game setting, from fantasy realms to sci-fi dystopias.
+        - **👤 Character Creation**: Customize your protagonist's name, age, background, and personality.
+        - **🎭 Genre Selection**: Choose from a variety of genres to set the tone of your story (e.g., Fantasy, Sci-Fi, Mystery).
+        - **🖼️ Visual & Audio Experience**: The AI generates images and background music to accompany the scenes, immersing you in the story.
+        - **✍️ Interactive Choices**: Guide the narrative by selecting from AI-generated options or writing your own custom actions.
+        
+        ## 🛠️ How It Works
+        
+        1.  **Construct Your World**: Use the forms to describe the setting and your character.
+        2.  **Choose a Genre**: Select the style of your adventure.
+        3.  **Start the Game**: The AI will generate the opening scene based on your setup.
+        4.  **Make Your Choices**: Interact with the story by choosing from a list of actions or writing your own.
+        5.  **Experience Your Story**: Watch as the AI dynamically creates a unique story with text and images just for you.
+        
+        ## 📊 Agent Demo
+        This Space showcases **intelligent agent capabilities for creative writing**:
+        - Dynamic story and scene generation.
+        - Contextual understanding of player choices.
+        - AI-powered generation of text, images, and music.
+        
+        ---
+        """)

src/game_constructor.py

@@ -1,16 +1,14 @@
 import gradio as gr
 import json
 import uuid
-from game_setting import Character, GameSetting, get_user_story
-from game_state import story, state, get_current_scene
-from agent.llm_agent import process_user_input
-from images.image_generator import generate_image
 from game_setting import Character, GameSetting
 from agent.runner import process_step
 from audio.audio_generator import start_music_generation, change_music_tone
 from agent.music_agent import generate_music_prompt
 import asyncio
-from config import settings
+from logging import getLogger
+
+logger = getLogger(__name__)
 
 
 # Predefined suggestions for demo
@@ -87,7 +85,15 @@ def save_game_config(
 ):
     """Save the game configuration to a JSON file"""
     if not all(
-        [setting_desc, char_name, char_age, char_background, char_personality, genre]
+        s.strip()
+        for s in [
+            setting_desc,
+            char_name,
+            char_age,
+            char_background,
+            char_personality,
+            genre,
+        ]
     ):
         return "❌ Please fill in all fields before saving."
 
@@ -127,8 +133,8 @@ async def start_game_with_settings(
         [setting_desc, char_name, char_age, char_background, char_personality, genre]
     ):
         return (
-            gr.update(visible=True),  # constructor_interface
             gr.update(visible=False),  # loading indicator
+            gr.update(visible=True),  # constructor_interface
             gr.update(visible=False),  # game_interface
             gr.update(
                 value="❌ Please fill in all fields before starting the game.",

src/main.py

@@ -15,6 +15,7 @@ from game_constructor import (
     load_character_suggestion,
     start_game_with_settings,
 )
+from app_description import app_description
 
 CONCURRENCY_LIMIT = 100
 
@@ -34,12 +35,14 @@ async def return_to_constructor(user_hash: str):
         gr.update(visible=False),  # game_interface
         gr.update(visible=False),  # error_message
     )
-    
+
+
 async def generate_user_hash():
     hash = str(uuid.uuid4())
     logger.info(f"Generated user hash: {hash}")
     return gr.update(value=hash)
 
+
 async def update_scene(user_hash: str, choice):
     logger.info(f"Updating scene with choice: {choice}")
     if not isinstance(choice, str):
@@ -142,18 +145,16 @@ with gr.Blocks(
     with gr.Column(
         visible=True, elem_id="constructor-interface", elem_classes=["constructor-page"]
     ) as constructor_interface:
-        gr.Markdown("# 🎮 Interactive Game Constructor")
-        gr.Markdown(
-            "Create your own interactive story game by defining the setting, character, and genre!"
-        )
+        with gr.Row():
+            app_description()
 
-        # Error message area
-        error_message = gr.Textbox(
-            label="⚠️ Error",
-            visible=False,
-            interactive=False,
-            elem_classes=["error-message"],
-        )
+        with gr.Row():
+            error_message = gr.Textbox(
+                label="⚠️ Error",
+                visible=False,
+                interactive=False,
+                elem_classes=["error-message"],
+            )
 
         with gr.Row():
             with gr.Column(scale=2):
@@ -339,7 +340,7 @@ with gr.Blocks(
             error_message,
         ],
     )
-    
+
     game_choices.change(
         fn=update_scene,
         inputs=[ls_user_hash, game_choices],