v1.14 STEM Template

README.md

@@ -1,75 +1,45 @@
 ---
-app_file: app.py
+title: STEM Adventure Games
+emoji: 💬
 colorFrom: blue
 colorTo: green
-emoji: 🤖
-license: mit
-pinned: false
 sdk: gradio
 sdk_version: 5.39.0
-short_description: Choose your own STEM adventure games
-title: STEM Adventure Games
+app_file: app.py
+pinned: false
+license: mit
+short_description: Interactive STEM adventure game guide
 ---
 
 # STEM Adventure Games
 
-Choose your own STEM adventure games
-
-## Quick Deploy to HuggingFace Spaces
+Interactive STEM adventure game guide
 
-### Step 1: Create the Space
-1. Go to https://huggingface.co/spaces
-2. Click "Create new Space"
-3. Choose a name for your Space
-4. Select **Gradio** as the SDK
-5. Set visibility (Public/Private)
-6. Click "Create Space"
+## Quick Setup
 
-### Step 2: Upload Files
-1. In your new Space, click "Files" tab
-2. Upload these files from the zip:
-   - `app.py`
-   - `requirements.txt`
-   - `config.json`
-   - `README.md`
-3. Wait for "Building" to complete
+### Step 1: Configure API Key (Required)
+1. Get your API key from https://openrouter.ai/keys
+2. In Settings → Variables and secrets
+3. Add secret: `API_KEY`
+4. Paste your OpenRouter API key
 
+### Step 2: Configure HuggingFace Token (Optional)
+1. Get your token from https://huggingface.co/settings/tokens
+2. In Settings → Variables and secrets
+3. Add secret: `HF_TOKEN`
+4. Paste your HuggingFace token (needs write permissions)
+5. This enables automatic configuration updates
 
-### Step 3: Add Access Code (Required)
-1. In Settings, click "Variables and secrets"
-2. Click "New secret"
-3. Name: `ACCESS_CODE`
-4. Value: Your chosen access code/password
-5. Click "Add"
-6. **Important**: Share this code with your students!
 
-### Step 4: Add OpenRouter API Key
-1. Get your API key from https://openrouter.ai/keys
-2. In your Space Settings, click "Variables and secrets"
-3. Click "New secret"
-4. Name: `API_KEY`
-5. Value: Your OpenRouter API key (starts with `sk-or-`)
-6. Click "Add"
 
-### Step 5: Test Your Space
-- Go back to "App" tab
-- Your Space should be running!
-- Try the example prompts or ask a question
+### Step 3: Test Your Space
+Your Space should now be running! Try the example prompts or ask your own questions.
 
 ## Configuration
-
-- **Model**: google/gemma-3-27b-it
+- **Model**: google/gemini-2.0-flash-001
 - **API Key Variable**: API_KEY
-- **Access Code Variable**: ACCESS_CODE
-
-## Faculty Configuration
-
-If you set `HF_TOKEN` and `SPACE_ID` environment variables, a Configuration tab will appear allowing you to:
-- Edit the system prompt
-- Change the AI model
-- Update example prompts
-- Modify grounding URLs
-- Adjust temperature and response length
-- Lock configuration to prevent further changes
+- **HF Token Variable**: HF_TOKEN (for auto-updates)
+- **Access**: Public
 
-Changes save automatically and the Space restarts to apply them.
+## Support
+For help, visit the HuggingFace documentation or community forums.

app.py

@@ -13,7 +13,7 @@ from typing import List, Dict, Optional, Any, Tuple
 
 # Configuration
 SPACE_NAME = 'STEM Adventure Games'
-SPACE_DESCRIPTION = 'Interactive scientific methodology and mathematical reasoning adventure guide'
+SPACE_DESCRIPTION = 'Interactive STEM adventure game guide'
 
 # Default configuration values
 DEFAULT_CONFIG = {
@@ -22,10 +22,10 @@ DEFAULT_CONFIG = {
     'system_prompt': "Transform into an interactive co-learning guide who creates Choose Your Own STEM Adventure games featuring historically significant scientific experiments, opening each session with an eye-catching unicode-styled arcade menu presenting 5-6 adventures drawn from Wikipedia's List of Experiments with brief enticing descriptions, then immersing players in vivid historical moments written in second person (e.g. 'You are Galileo Galilei') that establish the year, location, prevailing beliefs, and tensions between established wisdom and emerging observations, presenting 3-4 numbered decision points per stage that reflect authentic scientific choices ranging from experimental design and measurement approaches to strategic decisions about convincing skeptics or timing publications, with each choice meaningfully different and leading to distinct paths forward, then narrating results with sensory details, colleague reactions, and unexpected observations that teach concepts naturally through unfolding drama rather than lectures, always ending scenes with new branching choices that maintain narrative momentum while reinforcing science as an iterative process of hypothesis, testing, and refinement, offering backtracking options to emphasize how so-called failed experiments provide crucial insights, balancing historical accuracy with engaging gameplay that shows how systematic thinking and creative problem-solving combine in scientific breakthroughs.",
     'temperature': 0.6,
     'max_tokens': 1000,
-    'model': 'meta-llama/llama-3.1-70b-instruct',
+    'model': 'google/gemini-2.0-flash-001',
     'api_key_var': 'API_KEY',
-    'theme': 'Monochrome',
-    'grounding_urls': [],
+    'theme': 'Soft',
+    'grounding_urls': ["https://en.wikipedia.org/wiki/List_of_experiments", "https://en.wikipedia.org/wiki/Scientific_method", "https://en.wikipedia.org/wiki/List_of_experiments#Biology", "https://en.wikipedia.org/wiki/List_of_experiments#Astronomy", "https://en.wikipedia.org/wiki/List_of_experiments#Chemistry", "https://en.wikipedia.org/wiki/List_of_experiments#Physics", "https://en.wikipedia.org/wiki/List_of_experiments#Geology"],
     'enable_dynamic_urls': True,
     'enable_file_upload': True,
     'examples': ['Initiate adventure!', 'How do I play?', "What's the meaning of this?"],
@@ -623,10 +623,7 @@ def create_interface():
                             examples=formatted_examples,
                             type="messages",
                             additional_inputs=additional_inputs if additional_inputs else None,
-                            submit_btn="Send",
-                            clear_btn="Clear",
-                            undo_btn=None,
-                            retry_btn=None
+                            submit_btn="Send"
                         )
                         
                         # Export functionality using DownloadButton

config.json

@@ -1,8 +1,8 @@
 {
   "name": "STEM Adventure Games",
-  "description": "Interactive scientific methodology and mathematical reasoning adventure guide",
+  "description": "Interactive STEM adventure game guide",
   "system_prompt": "Transform into an interactive co-learning guide who creates Choose Your Own STEM Adventure games featuring historically significant scientific experiments, opening each session with an eye-catching unicode-styled arcade menu presenting 5-6 adventures drawn from Wikipedia's List of Experiments with brief enticing descriptions, then immersing players in vivid historical moments written in second person (e.g. 'You are Galileo Galilei') that establish the year, location, prevailing beliefs, and tensions between established wisdom and emerging observations, presenting 3-4 numbered decision points per stage that reflect authentic scientific choices ranging from experimental design and measurement approaches to strategic decisions about convincing skeptics or timing publications, with each choice meaningfully different and leading to distinct paths forward, then narrating results with sensory details, colleague reactions, and unexpected observations that teach concepts naturally through unfolding drama rather than lectures, always ending scenes with new branching choices that maintain narrative momentum while reinforcing science as an iterative process of hypothesis, testing, and refinement, offering backtracking options to emphasize how so-called failed experiments provide crucial insights, balancing historical accuracy with engaging gameplay that shows how systematic thinking and creative problem-solving combine in scientific breakthroughs.",
-  "model": "meta-llama/llama-3.1-70b-instruct",
+  "model": "google/gemini-2.0-flash-001",
   "api_key_var": "API_KEY",
   "temperature": 0.6,
   "max_tokens": 1000,
@@ -11,8 +11,16 @@
     "How do I play?",
     "What's the meaning of this?"
   ],
-  "grounding_urls": [],
+  "grounding_urls": [
+    "https://en.wikipedia.org/wiki/List_of_experiments",
+    "https://en.wikipedia.org/wiki/Scientific_method",
+    "https://en.wikipedia.org/wiki/List_of_experiments#Biology",
+    "https://en.wikipedia.org/wiki/List_of_experiments#Astronomy",
+    "https://en.wikipedia.org/wiki/List_of_experiments#Chemistry",
+    "https://en.wikipedia.org/wiki/List_of_experiments#Physics",
+    "https://en.wikipedia.org/wiki/List_of_experiments#Geology"
+  ],
   "enable_dynamic_urls": true,
   "enable_file_upload": true,
-  "theme": "Monochrome"
+  "theme": "Soft"
 }