# app.py - Game-Based Learning with Free Models import streamlit as st import os import time import random import json import base64 import requests import re from PIL import Image import io import matplotlib.pyplot as plt from transformers import pipeline import torch # Configure Streamlit page st.set_page_config( page_title="StoryCoder - Learn Coding Through Games", page_icon="🎮", layout="wide", initial_sidebar_state="expanded" ) # Custom CSS for game-themed UI st.markdown(""" """, unsafe_allow_html=True) # Initialize session state def init_session_state(): if 'story' not in st.session_state: st.session_state.story = "" if 'concepts' not in st.session_state: st.session_state.concepts = [] if 'game_scenario' not in st.session_state: st.session_state.game_scenario = "" if 'game_code' not in st.session_state: st.session_state.game_code = "" if 'game_explanation' not in st.session_state: st.session_state.game_explanation = "" if 'game_preview' not in st.session_state: st.session_state.game_preview = "" if 'active_tab' not in st.session_state: st.session_state.active_tab = "story" if 'loading' not in st.session_state: st.session_state.loading = False # Concept database CONCEPTS = { "loop": { "name": "Loop", "emoji": "🔄", "description": "Loops repeat actions multiple times", "example": "for i in range(5):\n print('Hello!')", "color": "#FF9E6D", "game_example": "Repeating a jump 5 times to cross a river" }, "conditional": { "name": "Conditional", "emoji": "❓", "description": "Conditionals make decisions in code", "example": "if sunny:\n go_outside()\nelse:\n stay_inside()", "color": "#4ECDC4", "game_example": "Choosing different paths based on obstacles" }, "function": { "name": "Function", "emoji": "✨", "description": "Functions are reusable blocks of code", "example": "def greet(name):\n print(f'Hello {name}!')", "color": "#FFD166", "game_example": "Creating a jump function used multiple times" }, "variable": { "name": "Variable", "emoji": "📦", "description": "Variables store information", "example": "score = 10\nplayer = 'Alex'", "color": "#FF6B6B", "game_example": "Keeping track of collected stars" }, "list": { "name": "List", "emoji": "📝", "description": "Lists store collections of items", "example": "fruits = ['apple', 'banana', 'orange']", "color": "#1A535C", "game_example": "Storing collected treasures in a backpack" } } # Load models with caching @st.cache_resource def load_text_generator(): """Load a free text generation model""" try: # Using a smaller model for better performance return pipeline("text-generation", model="gpt2") except: return None # Analyze story and extract concepts def analyze_story(story): """Analyze story and identify programming concepts""" story_lower = story.lower() detected_concepts = [] # Check for loops if any(word in story_lower for word in ["times", "repeat", "again", "multiple"]): detected_concepts.append("loop") # Check for conditionals if any(word in story_lower for word in ["if", "when", "unless", "whether", "decide"]): detected_concepts.append("conditional") # Check for functions if any(word in story_lower for word in ["make", "create", "do", "perform", "cast"]): detected_concepts.append("function") # Check for variables if any(word in story_lower for word in ["is", "has", "set to", "value", "score"]): detected_concepts.append("variable") # Check for lists if any(word in story_lower for word in ["and", "many", "several", "collection", "items"]): detected_concepts.append("list") return list(set(detected_concepts)) # Generate game scenario using free models def generate_game_scenario(story, concepts): """Generate a game scenario based on the story and concepts""" try: # Create prompt prompt = ( f"Create a children's educational game based on this story: {story}\n" f"Game should teach these programming concepts: {', '.join(concepts)}\n" "Structure response with:\n" "Game Title: ...\n" "Game Objective: ...\n" "Characters: ...\n" "Game Mechanics: ...\n" "Coding Concepts: ...\n" "Visual Description: ...\n" ) # Generate with free model generator = load_text_generator() if generator: result = generator( prompt, max_length=400, do_sample=True, temperature=0.7, num_return_sequences=1 ) return result[0]['generated_text'] except Exception as e: st.error(f"Text generation error: {str(e)}") # Fallback scenario concept_names = [CONCEPTS[c]["name"] for c in concepts] return ( f"Game Title: {story[:20]} Adventure\n\n" f"Game Objective: Complete challenges based on the story: {story[:100]}...\n\n" "Characters: Hero character based on the story\n\n" "Game Mechanics: Navigate through levels, collect items, solve puzzles\n\n" f"Coding Concepts: This game teaches {', '.join(concept_names)} through gameplay\n\n" "Visual Description: Colorful 3D world with characters and obstacles" ) # Generate game code explanation def generate_game_explanation(story, concepts, game_scenario): """Generate explanation of game code""" try: # Create prompt prompt = ( f"Explain how a game based on this story teaches programming concepts to children: {story}\n" f"Game Scenario: {game_scenario}\n" f"Concepts: {', '.join(concepts)}\n" "Use simple language and analogies for kids aged 6-12." ) # Generate with free model generator = load_text_generator() if generator: result = generator( prompt, max_length=300, do_sample=True, temperature=0.7, num_return_sequences=1 ) return result[0]['generated_text'] except: pass # Fallback explanation concept_explanations = "\n".join( [f"- {CONCEPTS[c]['name']}: {CONCEPTS[c]['game_example']}" for c in concepts] ) return ( f"In this game based on your story '{story[:20]}...', we use programming concepts to make it work:\n" f"{concept_explanations}\n\n" "The code brings your story to life in a 3D game world!" ) # Generate simple game code def generate_game_code(story, concepts): """Generate simple PyGame code for the game""" # Extract game elements from story character = "hero" goal = "treasure" obstacles = ["rock", "tree", "river"] if "knight" in story.lower(): character = "knight" goal = "dragon" elif "space" in story.lower(): character = "astronaut" goal = "planet" elif "jungle" in story.lower(): character = "explorer" goal = "temple" # Generate dynamic game code return f""" # {story[:30]} Adventure Game import pygame import random # Initialize pygame pygame.init() # Game setup WIDTH, HEIGHT = 800, 600 screen = pygame.display.set_mode((WIDTH, HEIGHT)) pygame.display.set_caption("{story[:20]} Adventure") clock = pygame.time.Clock() # Colors BACKGROUND = (173, 216, 230) # Light blue PLAYER_COLOR = (255, 0, 0) # Red GOAL_COLOR = (0, 255, 0) # Green OBSTACLE_COLOR = (139, 69, 19) # Brown # Player setup player_size = 50 player_x = 100 player_y = HEIGHT // 2 player_speed = 5 # Goal setup goal_size = 40 goal_x = WIDTH - 150 goal_y = HEIGHT // 2 # Variables concept: Tracking score score = 0 font = pygame.font.SysFont(None, 36) # List concept: Creating obstacles obstacles = [] for i in range(5): obstacles.append([ random.randint(200, WIDTH - 100), random.randint(50, HEIGHT - 100), random.randint(20, 50), random.randint(20, 50) ]) # Game loop running = True while running: # Event handling for event in pygame.event.get(): if event.type == pygame.QUIT: running = False # Player movement keys = pygame.key.get_pressed() if keys[pygame.K_UP]: player_y -= player_speed if keys[pygame.K_DOWN]: player_y += player_speed if keys[pygame.K_LEFT]: player_x -= player_speed if keys[pygame.K_RIGHT]: player_x += player_speed # Boundary checking player_x = max(0, min(WIDTH - player_size, player_x)) player_y = max(0, min(HEIGHT - player_size, player_y)) # Collision detection with goal player_rect = pygame.Rect(player_x, player_y, player_size, player_size) goal_rect = pygame.Rect(goal_x, goal_y, goal_size, goal_size) # Conditional concept: Check for collision if player_rect.colliderect(goal_rect): # Function concept: Increase score score += 1 # Move goal to new position goal_x = random.randint(100, WIDTH - 100) goal_y = random.randint(50, HEIGHT - 100) # Drawing screen.fill(BACKGROUND) # Draw obstacles for obstacle in obstacles: pygame.draw.rect(screen, OBSTACLE_COLOR, (obstacle[0], obstacle[1], obstacle[2], obstacle[3])) # Draw player and goal pygame.draw.rect(screen, PLAYER_COLOR, (player_x, player_y, player_size, player_size)) pygame.draw.rect(screen, GOAL_COLOR, (goal_x, goal_y, goal_size, goal_size)) # Display score score_text = font.render(f"Stars: {{score}}", True, (0, 0, 0)) screen.blit(score_text, (20, 20)) # Display character type char_text = font.render(f"Character: {character.title()}", True, (0, 0, 0)) screen.blit(char_text, (20, 60)) # Update display pygame.display.flip() clock.tick(60) pygame.quit() """ # Generate game preview visualization def generate_game_preview(game_scenario): """Generate a visual preview of the game""" try: # Extract title from game scenario title_match = re.search(r"Game Title: (.+)", game_scenario) title = title_match.group(1) if title_match else "Your Adventure" # Create a simple visualization fig, ax = plt.subplots(figsize=(10, 6)) ax.set_facecolor('#a2d2ff') ax.set_xlim(0, 10) ax.set_ylim(0, 6) # Draw game elements ax.text(5, 5, title, fontsize=20, ha='center', color='#9b5de5') ax.plot([1, 9], [3, 3], 'k-', linewidth=2) # Ground # Player character ax.plot(2, 3.5, 'ro', markersize=15) # Goal ax.plot(8, 3.5, 'go', markersize=15) # Obstacles for i in range(3): x = random.uniform(3, 7) y = random.uniform(3.2, 4) ax.plot(x, y, 's', color='#8d99ae', markersize=12) # Path ax.plot([2, 8], [3.5, 3.5], 'y--', linewidth=2) ax.axis('off') ax.set_title("Game Preview", fontsize=16) # Save to bytes buf = io.BytesIO() plt.savefig(buf, format='png', dpi=100, bbox_inches='tight') buf.seek(0) return buf except: return None # Main application function def main(): init_session_state() st.title("🎮 StoryCoder - Learn Coding Through Games!") st.subheader("Turn your story into a 3D game and discover coding secrets!") # Create tabs st.markdown('
pip install pygamepython your_game.py{details['description']}
In your game: {details['game_example']}
{details['example']}
pip install pygamemy_game.pypython my_game.py